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How to Use This Manual 


1.1. Purpose This manual is a guide to help you take your Sun Woikstation® from initial 

hardware power-up through SunOS'™ installation. This manual breaks down the 
installation so that even if you are new to UNIXt and Sun architecture types, you 
can perform a basic installation. 



This manual is intended for installing of SunOS 4.0 J, or upgrading to 
SunOS 4.0 J. For installing or upgrading other versions of the SunOS, see the 
installation manual for the specific release. 


1.2. Intended Audience SunOS is distributed to a wide customer base with a broad range of technical 

expertise. This manual provides information for beginning through advanced 
levels. 

Beginning and intermediate level users should read through the major sections of 
this document before beginning the upgrade or installation process. Advanced 
level users should review this document for information on differences in 
upgrading to, or installing SunOS 4.0.3, as well as a basic reference document. 

1.3. Document Structure This manual is divided into the following nine chapters: 

o Chapter 1. How to Use This Manual gives you an overview of the entire 
document. It teUs what to expect in the installation and where to locate cer¬ 
tain types of information. It also refers you to related documents for more 
information in specified areas. 

□ Chapter 2. What You Should Know Before Installing SunOS introduces 
the beginning user to local and remote installations and provides an installa¬ 
tion roadmap that gives a big picture of the installation process. A 
definition of woiking terminology is provided to familiarize the beginning 
user with machine types, network terminology, operating system terminol¬ 
ogy, and SunOS device names. 


t UNIX is a registered trademark of AT&T. 
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4 Installing the SunOS 4.0.3 


Pay particular attention to the Changes in SunOS section of this chapter. 

This section discusses the significant changes from SunOS 3.x to 4.x. The 
changes mentioned here are system changes that resulted in changes to the 
installation process for SunOS 4.x. 

Beginning and intermediate users should note the recommended pre¬ 
installation procedures listed at the end of this chapter. 

□ Chapter 3. Getting Started discusses the importance of planning disk 
space and provides a list of issues to consider for customizing your disk. 

This chapter also covers pre-installation procedures and the abort sequence. 

□ Chapter 4. Beginning the Installation leads you into the first of the instal¬ 
lation procedures. You learn how to load the distribution tape and bootstrap 
program. You also learn how to format the disk, copy the miniroot, and boot 
the miniroot. 

□ Chapter 5. How suninstall Works explains the suninstall program, its 
menus and menu options. This chapter is not meant to be used as a walk¬ 
through example. 

o Chapter 6. Walkthrough Examples gives you step-by-step walkthrough 
instructions for installing local and remote installations. Three walkthrough 
examples are provided for local installations; one for each configuration: 
standalone, server, and dataless. One remote installation walkthrough is pro¬ 
vided to illustrate the basic differences from a local installation. 

□ Chapter 7. Post-installation Procedures outlines post-installation pro¬ 
cedures to re-customize the environment. How to boot a pre-configured ker¬ 
nel and how to configure your own kernel is also covered. 

□ Chapter 8. Advanced Installation Issues covers the use of 
setup_client and setup_exec. These utilities allow you to add 
software after the installation is complete, covert a standalone system to a 
server, and add or delete clients. 

□ Chapter 9. Performing a System Upgrade explains the differences 
between a system upgrade and a complete installation. It also covers back¬ 
ground information necessary for performing a system upgrade, and pro¬ 
vides walkthrough examples for four system configurations. 

o Chapter 10. Reference includes the setup_client (8), setup_exec 
and sunupgrade (8) manual pages, as well as a glossary. 

□ Appendix A: SunOS 4.0.3 and 3.x Directory Structures is a collection of 
tables representative of the SunOS 4.0.3 directory structure and 3.x directory 
structure respectively. By comparing the two directory stractures you can 
obtain a visual image of the changes that occurred in the directory structure 
from SunOS 3.x to SunOS 4.0.3. 

p Appendix B: Time Zones gives a list of acceptable time zone names. 

□ Appendix C: SunOS 4.0.3 Upgrade Tape Layout provides a list of 
software categories on the SunOS 4.0.3 Upgrade tape, the file sizes, and file 
types. 
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□ Appendix D: Installation Worksheets are worksheets to help you gather 
information for the installation and execute the installation smoothly and 
efficiently. 

□ Appendix E: suninstall Forms are sample forms in the suninstall program. 
Blank lines are provided so you can fill in these forms in advance and then 
start suninstall. 


1.4. Document Conventions Several Sim document conventions are used throughout this document to help 

make directions clear and consistent. The following is a list of the document 
conventions used in this manual. 

Font Types Various font types are used in this manual to distinguish between information 

you key in, the information displayed by the system, and items that either you or 
the system replace with a variable. These font type conventions are as follows: 

□ bold listing font 

This font represents characters you key in. 
o listing font 

This font represents the response of the system that is displayed on the screen. It 
is also used for literal values such as program names, function names, procedure 
names, variable names, field types, file listings, and session output. 

□ bold italic font 

This font represents a variable. It is up to you to make the proper substitution. 

□ gray boxes 


Gray boxes represent dialogues you have with the system. As mentioned above, 
the bold listing font represents the characters you key in and listing font is the 
response of the system. 



□ plain boxes 

Plain boxes represent screen displays or system responses. There is no user 
interaction in these displays. 


-\ 

SERVER:/export/exec/sun2 /usr nfs ro,rsize=2048,wsize=2048 0 0 

_ ! 
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6 InstaUing the SunOS 4.03 


Icons 


The following icons are used throu^out this manual as visual signposts. 



□ Light Bulb 

The light bulb icon illuminates information that is nice to know. This is 
information that may answer questions as to why you are doing something, 
but is not critical to completing the installation. 




□ Pointing Hand 

The pointing hand icon points to information that requires close attention. 



□ Stop Sign 

The stop sign icon points to critical information that is essential for you to 
read. 



□ Exploding Workstation 

The exploding workstation icon is placed by information that is operative 
for you to read. If you skip over this material, it is possible that you can 
damage your system or cause the installation to fail. 



Feet 

The feet icon maiks the beginning of each walkthrough example. 


^sun 

Xr microsystems 
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Names of Manual Pages The following notation is used throughout this manual for reference to com¬ 

mands and utilities: 

passwd(l) 

This notation indicates the passwd manual page in Section 1 of the Commands 
r^erence Manual. 

Explanations for the noted commands and utilities can be found in one of the fol¬ 
lowing documents: 

□ Commands R^erence Manual 

□ Systems Interface Manual 

These documents contain a total of eight sections. The following table lists each 
section number and its corresponding manual. 


Section 

Manual 

1 

Commands Reference 

2 

System Interface 

3 

System Interface 

4 

System Interface 

5 

System Interface 

6 

Commands Reference 

7 

Commands Reference 

8 

Commands Reference 


The use of an appended letter after the command or utility indicates a specific 
category of command or a subsection. The following table lists examples of 
added notation. 


Category IS ubsection 

Notation 

Example 

Graphics 

G 

spline(IG) 

Math Library 

M 

title (3M) 

Network Library 

N 

title(3N) 


1.5. Related Manuals The following manuals may be helpful as reference documents: 

□ System and Network Administration 

□ SunOS Reference Manual 
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What You Should Know Before You 

Install SunOS 


2.1. Introduction This chapter covers the basics of the installation process and new enhancements 

to SunOS that affect installation. It also helps you determine if your system 
requires a full installation or a system upgrade. This issue is covered in the next 
section, Installation or Upgrade. 

In the Working Terminology section, local and remote installations are defined 
and basic terminology is covered. 

Changes to SunOS that affect installation are covered in the second part of this 
chapter. SunOS Release 4.x has many added enhancements that qudify it as 
significantly different from previous Sun releases. This section covers the 
SunOS 4.x features and the differences they incur in the installation process. 

Installation roadmaps are presented at the end of this chapter. There is a road¬ 
map for a first-time installation and one for a re-installation of an existing sys¬ 
tem. 

2.2. Installation or The differences between an upgrade and a/w// installation, are as follows: 

Upgrade. ^ Full Installation 

With a full installation, an entire operating system is installed; this 
overwrites the existing operating system and all filesytems. A full installa¬ 
tion is typically required for a major release of the operating system; when 
there are too many significant changes to selectively replace files. 

□ System Upgrade 

With a system upgrade, only those files that are different between the release 
you are running and the new release are installed, sunupgrade preserves 
your current filesystem and customizable administrative files in the process 
of replacing the selected files. An upgrade is typically used for a minor 
release of the operating system where selective files can be replaced. 

Methods for Installation and The methods available for implementing a full installation and a system upgrade 
Upgrade differ. The full installation has a separate set of distribution tapes than does the 

upgrade. You can only perform a system upgrade if you have the SunOS 
Upgrade tape. 

The following methods are available for performing a full installation of SunOS 
4.0.3: 
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When to Perform a Full 
Installation 


When to Perform a System 
Upgrade 


2.3. What Happens When 
You Install 


Full Installation: 

□ SunOS 4.0.3 Full Install tape set 

□ SunOS 4.0 Full Install tape set accompanied with a SunOS 4.0.3 Upgrade 
tape 

The following method is available for performing a system upgrade to SunOS 
4.0.3: 

System Upgrade: 
o SunOS 4.0.3 Upgrade tape 

You must perform a full installation under the following circumstances: 

□ You want to bring up a new system that does not have a previous OS 
installed. 

□ You want to migrate from a 3.x release to a 4.x release. 

If either of these simations are reflective of your site, continue reading this 
chapter and the rest of the manual. 

You should only perform a system upgrade under the following condition: 

□ You are currently miming SunOS 4.x and want to migrate to SunOS 4.0.3. 

If this is the situation at your site, go directly to Chapter 9, Performing a System 
Upgrade. This chapter covers the necessary information for performing a system 
upgrade, and provides walkthrough examples for four system configurations. 

Installation is the term used for loading the operating system software and bring¬ 
ing up your workstation. This document covers the following two installation 
types: 

□ Install a new system 

a Re-install an existing system 


The basic installation process consists of the following steps: 

1. Loading the bootstrap program. 

2. Copying and booting MUNIX. 

3. Formatting the disk 

4. Copying and booting the miniroot 

5. Running suninstall 

6. OPTIONAL: Install a small pre-configured kernel, if applicable. See the 
Post-installation Procedures chapter of this manual for more information. 

7. Booting the system 


micros ystems 
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8. Configure a custom kernel, if you did not install a small kernel. 


2.4. Working Terminology The following terms are used in the installation procedures: 

Local Installation With a local installation, a disk and tape drive are connected to the machine on 

which you are installing SunOS. This machine may or may not be connected to a 
network. 

Remote Installation With a remote installation, the machine you are installing does not have a tape 

drive connected to it (local tape drive), but there is a local disk. Instead of using 
a local tape drive, you use the tape drive of another machine on a network to per¬ 
form the installation. This type of installation, by definition, requires that the 
system you are installing be connected to the network. 



The tapehost (remotehost) must be rurming SunOS 4.x before you can perform a 
remote installation of SunOS 4.x. 


Machine Types This section covers the four possible machine types. Your site may have one 

'Sw' type or it may be a network with a combination of the following types. 

Standalone 

A standalone system has a local disk. It may or may not be attached to a 
network. If attached to a network, it may or may not have a local tape drive. 
A standalone workstation is also self-sufficient in terms of storage, and has a 
complete root filesystem, user filesystem, and local swap on its disk. It does 
not require another machine or network to boot UNIX. 

Server 

A server system on a local network provides resources such as network ser¬ 
vices and disk storage for other machines, which are called “clients”. For 
installation purposes, the term “server” means “network file server”. A 
server uses the NFS (“Network File System" — see nf s (4P)) protocols to 
provide filesystem services to its clients. 

Homogeneous Server 

A homogeneous server is a server that serves clients only of its own architec¬ 
ture. For example, a Sun-3 server that serves only Sun-3 clients is a homo¬ 
geneous server. 

Heterogeneous Server 

A heterogeneous server is a server that serves clients of different architec¬ 
tures that itself. For example, a Sun-4 server that serves Sun-2 and Sun-3 
clients is a heterogeneous server. 

v,... Diskless Qient 

A client woikstation on a local network relies on a server for disk storage. 
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Networking Terminology 


Installing a diskless client workstation requires that you complete the instal¬ 
lation on its server and then power on the workstation. The things you need 
to know about the client for server installation include the following: 

□ client name 

D hardware Ethernet address of client machine 

See the Networking Terminology section that follows. 

□ Internet or IP address of client machine 


See the Networking Terminology section that follows, 
o yellow pages type 

("client" or "none") diskless machines are usually not a YP server 

□ pathname of the root directory for client: 

/export/root/clientname 

□ pathname of swap for client: / export / swap/clientname 

□ pathname of the home directory for client: /home 

□ pathname to executables of client architecture type: 

/export/exec/sun2,sun3,sun3x,sun4 or sun4c 


□ amoimt of disk space to reserve for client swap area 
Dataless Client 

A dataless client workstation on a local netwoik relies on a server for its 
/usr partition, but has a local disk where it stores its root and swap par¬ 
titions. A dataless client can boot the operating system from its local disk, 
however, it requires the /usr filesystem from a remote machine to come up 
single user and multi-user. In other words, some of its files are local, and 
others are remote. The remote files can be obtained from any machine mn- 
ning NFS which supports the dataless client’s architecture. 



This section defines the basic network terminology relevant to configuring your 
netwoik. 

For additional information on networking, see Determining Network Information 
in the next chapter or the System and Network Administration manual. 

Hostname or Machine Name 

Name of the workstation. Each machine in the network is assigned a unique 
hostname. A machine with more than one interface (i.e. a router which has 
an interface on each of two different networks) requires a unique hostname 
for each interface. 

Ethernet Address 

Refers to the address permanently assigned to each workstation. 


microsystems 
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Internet Address 

A unique number assigned to each machine; also known as the IP address. It 
consists of two parts: the network: number followed by the host number. 

Domain Name 

The domain name identifies a group of workstations on a single local net¬ 
work that share some administrative files. 

Remotehost 

The remotehost is the machine that supplies both the server and tape drive 
capabilities during a remote installation. 

Tapehost 

A tapehost is a machine which has the tape drive that is used during a remote 
installation. 

Target Machine 

During a remote installation, the target machine is the machine you are 
installing. 


Operating System This section covers basic operating system terminology applicable to installing 

Terminology SunOS. 

SunOS 

SunOS is the Sun UNIX based operating system that incorporates Berkeley 
4.2 and System V. It is referred to in this manual as the SunOS or the 
operating system. 

miniroot 

The miniroot is a very small version of the operating system temporarily 
loaded into the swap partition. The miniroot gives you just enough func¬ 
tionality to install the overall operating system. 

format 

format is a SunOS utility that enables you to format, label, repair and 
analyze disks on your Sun system. For more information, see the System 
and Network Administration manual. 

MUNIX 

MUNIX is a small version of the operating system that is loaded from tape or 
over the network into memory rather than onto disk. It is a useful tool when 
format operation must be run on your local system disk. 


SunOS Device Names This section covers the various device names used by the operating system. 

These names can be arbitrary, such as the user-defined hosmame, but are often 
based on abbreviations for the controllers used to connect the devices. 


3 ^ 


During installation, you are prompted for the tape, disk, and ethernet names. The 
following is a list of possible device names and Ethernet types with their 
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appropriate notations. Check your system to verify your device names and Eth¬ 
ernet type and make note of them for the upcoming installation. 



Table 2-1 Tape Devices 


Name 

Device Description 

ar 

Archive 1/4" tape cartridge 

mt 

Nine-track magnetic ip.” tape-Tapemaster controller 

St 

SCSI 1/4" tape cartridge 

xt 

Nine-track magnetic 1/2" tape-Xylogics 472 controller 


Table 2-2 


Table 2-3 


Disk Devices 


Name 

Device Description 

xy 

Xylogics 450/451 SMD disk controller 

sd 

SCSI disk controller 

xd 

Xylogics 7053 disk controller 

fd 

Integrated floppy controller 


SCSI floppy controller 


'<m0^ 

Ethernet Types 


Name 

ec 

ie 

le 


_ Type Description _ 

3COM ethemet controller, some Sxm-2 machines 

most Sun-2, Sun-3/75, Sun-3/100, Sun-3/200 and Sun-4 ethemet controller 

Sun-3/50, Sun-3/60 and Sun-3/Eurocard ethemet controller 
Sun-3/80, Sun-4/330 


2.5. SunOS 4.x Server 
Information 

As with previous releases, it is recommended that networks be configured with 
servers at least as powerful as their clients, especially for diskless operation. For 
example, it is preferred to have a Sun-4 server serving Sun-2, Sun-3, and/or Sun- 
4 clients. It is NOT recommended to have a Sun-2 server serving Sun-3 and 
Sun-4 clients. 

All Sun-2, Sun-3, and Sun-4 clients of a server can be upgraded to SunOS 4.0.3. 
For more information on system upgrades for server configurations, see the Per¬ 
forming a System Upgrade chapter in this manual. 
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Installing From Mixed Types suninstall does not currently support installation of different architectures on a 
of Distribution Tapes heterogeneous server from different tape drives. An example of this would be 

installing a Sun-3 heterogeneous server by loading the Sun-3 software from a 
local \p." tape drive and the Sun-2 software finm a remote 1/4" tape drive. 

If it is necessary to perform such an installation, install the machine as a homo¬ 
geneous server being sure to select Install optional software. Bring up the 
system and use setup_exec and setup_client to add the heterogeneous 
software and clients. 


Supporting Sun386i Diskless A server kit is available with the Sun386i SunOS 4.0.1 distribution which allows 
Clients Sun-3 and Sun-4 servers running SunOS 4.x to support Sun386i diskless clients. 

If you are interested in miming 386i diskless clients on a Sun-3 or Sun-4 server, 
contact your Sun Sales Representative. The server kit uses the same tape media 
as the standard 386i SunOS 4.0.1 distribution. 


Special Server Installation The following issues are specific to selected configurations and/or architecture 

Issues types. 

Upgrading Dataless Clients As a safety feature when upgrading dataless clients, sunupgrade does not 

upgrade a dataless client to the new operating system release unless the server is 
already running the new release. For example, sunupgrade would not 
upgrade a dataless client to SunOS 4.0.3 unless the server was already mnning 
SunOS 4.0.3. 


Booting From Fast Servers Diskless Sun-2 machines and Sun lOOU machines with 3Com Ethernet interface 

(ecO) will have trouble booting from fast servers such as a Sun-3 or Sun-4. To 
correct this, use the following steps. 


1. On the machine named SERVER, do the following for the client named 
CLIENT: 



2. Be sure the client’s /etc/f stab entries have the rsize and wsize 

options set to 2K for any fast servers. For example, the entry for /usr 
should look similar to the following: 

CLIENT:/export/exec/sun2 /usr nfs ro,rsize=2048,wsize=2048 0 C 
V_> 


An alternate approach would be to upgrade the ec board to a Sun multibus Eth¬ 
ernet board (ieO). To do this, see your sales representative for details. 
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2.6. Server Support of The SunOS 4.0.3 product line includes support for new hardware architectures 

Sub-architectures that are largely compatible with existing Sun architectures, except for a slightly 

different kernel layout. This new type of architecture is called a sub¬ 
architecture. For example, a 68030 based Sun-3/80 is a sub-architecture of a 
Sun-3 and is called a Sun-3x. 

Hosts which share the same architecture but differ in their sub-architectures, can 
share most, but not all, of the executables. Due to the differences in the kernel 
structure for sub-architectures, programs that depend on a particular kernel layout 
must be located in a directory that is not shared across sub-architectures. 

The sub-architecture dependent files are located in /export/exec/kvm. Pro¬ 
grams that need to access the kernel while it is running need this file. Every 
diskless client must mount /export/exec/kvm, as well as, /usr. 
moimted/usris /export/exec/kvm is mounted on top of /usr. kvm files 
are moimted as a single point. 

The major-architecture is always the directory with the data and the sub¬ 
architecture is a symbolic link. The /export/exec/kvm directories are all 
actual directories, not symbolic links. 

As a result of sub-architecture kernel differences, you must specify the following 
two paths when installing a client on SunOS 4.0.3: 

□ Path for the architecture dependent executables 

□ Path for the sub-architecture dependent executables 

The path for the architecture dependent executables is called the exec path and 
is unchanged from SunOS 4.0. The default exec path is: 

/ export/exec/client_ARCH. 

The path for the sub-architecture dependent executables is called the kvm path 
and is new in SunOS 4.0.3. The default kvm path is: 

/export /exec /k-vm/client_ARCH . 



You define both the exec path and the kvm path on the Host Form, Software 
Form, and Qient Form in suninstall. 


2.7. Small Pre-configured A small pre-configured kernel is now available for installation on smaller sys- 
Kernels terns. With the added enhancements to 4.0.3, a small kernel is required for 

optimum performance. The small pre-configured kernel is eliminates the extra 
steps required for configuring a custom kernel. For information on the systems 
that support the small pre-configured kernel, as well as steps for installation, see 
the Post-installation Procedures chapter of this manual. 



Revision A, of 25 April 1989 



Chapter 2 — What You Should Know Before You Install SunOS 19 


Even with a smaller system, you stiU have the option of customizing your own 
kernel. For information on how to configure a custom kernel, see the Post¬ 
installation Procedures chapter of this manual. 


2.8. Changes to SunOS 
from 3.x to 4.x 

This section covers the major operating system changes from SunOS 3.x to 4.x. 
These changes have influenced the installation process for SunOS 4.x. 

Filesystem Reorganization Two major features of SunOS 4.x are the elimination of the Netwoik Disk Sys¬ 

tem partitioning and the reorganization of the filesystem. This new filesystem 
layout makes it easier for a single server to support clients of different architec¬ 
tures, while still maintaining most of the familiar filesystem layout. 

The Sun Netwoik File System (NFS) allows a computer with a local disk to act 
as a server by exporting its filesystems to clients on a netwoik. The client com¬ 
puters may themselves be servers of other local filesystems. When a client and 
server have the same architecture they can share executable programs or utilities. 

The New Layout In changing the layout of the filesystem for SunOS 4.x, the basic goals included 

the following: 

□ Easier maintenance of servers and clients 

o Easier mixing of remote and local filesystems 
o Cleaner support of multiple architectures 

□ Minimal dismption to existing programs 

□ Minimal symbolic link confusion 

Major Changes 

The following items highlight the major changes in the filesystem layout for 
SunOS 4.x. For more information on changes made to the system in SunOS 
Release 4.x, see the SunOS 4jc Change Notes. 

□ The directories /usr/adm, /usr/spool, and /usr/tmp have been 
moved into / var and symbolic links point from the old names to the new 
location. 


/usr 

Symbolic Link 

/var 

/usr/adm 

=> 

/var/adm 

/usr/spool 

=> 

/var/spool 

/usr/tmp 


/var/tmp 


o The sendmail configuration file has been moved from the /usr/lib direc¬ 
tory to / etc. There is no symbolic link pointing from the old location to 
the new location. 
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/usr Symbolic Link 

/etc 

/usr/lib/sendmail.cf 

/etc/sendmail.cf 


o The entire contents of /bin and /lib were moved to /usr/bin and 
/usr/lib respectively. The executables from /etc were moved to 
/usr/etc, leaving /etc exclusively containing system configuration 
files. Symbolic links are left behind for the directories /bin and /lib and 
for the individual files moved out of /etc. 


Old Location 

Symbolic Link 

/usr 

/bin 

=> 

/usr/bin 

/lib 

=> 

/usr/lib 

/etc/*name* 

=> 

/usr/etc/*name* 


□ A new directory, /usr/share, was added for files that can be shared 
across all architectures. It currently holds the manual pages (moved finm 
/usr/man), the kernel build directory (moved from /usr / sys), the 
SunView Programmers’ Source, and a few other files. Symbolic links were 
left behind in the original locations for most files and directories moved into 
/usr/share. 


Old Directory 

Symbolic Link 

New Directory 

/usr/man 


/usr/share/man 

/usr/sys 

=> 

/usr/share/sys 

/usr/src 


/usr/share/src 


□ The moimt points for home directories in the old filesystem layout were 
sub-directories of /usr. These have been moved to a new directory, 
/home. This allows the /usr filesystem to be mounted read-only, if 
desired. As with 3.x, you must mount each subdirectory on a client 
corresponding to a separate filesystem. The owner of a client machine can 
either have a local /home directory which is personally maintained, or 
mount the standard /home directory which is updated by an administrator. 


/usr 

Moved To 

New Location 

home directory 
mount points 


/home 


□ SunOS 4.0.3 brings the introduction of sub-architectures. With this intro¬ 
duction, a server which now serves multiple architectures must also supply 
architecture dependent executables for each client architecture configuration 
is serves. These export directories are kept in 

/export/exec/kvmA/?C// and are named according to the respective 
architectures. The path for each of these architecture dependent executable 
files is called the kvm path. 



Revision A, of 25 April 1989 




Chapter 2 — What You Should Know Before You Install SunOS 21 


Architecture 

kvm Path 

Sun-2 

/export/exec/kvm/sun2 

Sun-3 

/export/exec/kvm/sun3 

Sun-3x 

/export/exec/kvm/sun3x 

Sun-4 

/export/exec/kvm/sun4 

Sun-4c 

/export/exec/kvm/sun4c 


□ A server which supports multiple architectures or sub-architectures supplies 
multiple copies of the clients’ executables; one for each supported architec¬ 
ture. The exported filesystems are kept in the /export /exec directory 
and named according to the architecture supported. The path for each of 
these filesystems is called the exec path. When a server is sharing execut¬ 
ables with one or more of its clients the /export /exec entry for the 
shared executables will be a symbolic link to /usr. 


Architecture 

exec Path 

Sun-2 

/export/exec/sun2 

Sun-3 

/export/exec/sun3 

Sun-3x 

/export/exec/sun3x 

Sun-4 

/export/exec/sun4 

Sun-4c 

/export/exec/sun4c 


Using the New Filesystem It is recommended that you follow the rules listed below when writing or modi¬ 

fying programs that use the new filesystem layout. 

□ In general, /usr should be considered read-only and shared. It should con¬ 
tain only executables and libraries for a particular architecture. 

□ The directory /etc contains the identity of a particular machine. You can 
think of it as the home directory of the machine. It contains aU of the text 
files that make up the administrative databases of the machine. It also con¬ 
tains directories that are used for per-machine files. 

□ There are two directories that are used for temporary files: / tmp and 

/var/tmp. The /tmp directory should be used for small files and quick 
access. These files are removed when the machine is rebooted. The 
/var/ tmp directory should be used for larger and longer-lived files. 


2.9. Changes to sminstall in 
SunOS 4.x 


setup_client and setup_client and setup_exec were commands introduced in suninstall in 

setup_exec SunOS 4.x. setup_client allows you to add and delete clients. 

setup_exec allows you to install executable files for a specified architecture. 
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You can no longer use the ext ract_release command to extract additional 
software. You must use setup_exec to extract software from the same or 
other architectures or return to suninstall. 


Standalone/Server Conversion You can now turn a 4.x standalone system into a 4.x server without taking down 

or rebuilding the system. The setup_client command allows you to create a 
diskless client while the system is running in multiuser mode. This command 
also allows you to remove a client while the system is running in multiuser 
mode. 

For more information on adding and deleting clients, see Chapter 8, Advanced 
Installation Issues. 


Standalone and Homogeneous You can now turn a 4.x standalone system or a 4.x homogeneous server into a 4.x 

Server Conversion heterogeneous server while the system is running in multiuser mode. The 

setup_exec command allows you to specify the executables of the architec¬ 
ture to be loaded on the system. 

For more information on converting a standalone system to a server, see the 
Advanced Installation Issues of this manual. 


Installation Priority 


It is important that the first 4.x installation at a site be a local installation. You 
cannot perform a remote installation as the first 4.x installation at a site. This is 
due to the fact that the tapehost must be mnning SunOS 4.x before a remote 
installation can be performed. 



2.10. SunOS 4.x and 3.x For a clearer picture of the file system changes between 4.x and 3.x, compare the 

Directory Structures directory stmctures listed in the Appendix. Wherever an arrow ( =>) appears 

after a directory name, this indicates a symbolic link to the directory following 
the arrow (eg.: /bin usr/bin). 


2.11. Booting Issues Originally, the operating system executables were of a size so that all could fit in 

the root partition. Over time, however, executables have expanded in size and 
made it difficult to keep aU executables in root. 

With the new filesystem boot procedures, the executables that used to reside in 
the root partition have moved to /usr. This change makes it necessary to 
alter booting in single-user mode. 

In the previous filesystem layout, root contained the executable programs 
needed to repair a damaged system. This included programs such as fsck, 
dump and restore for patching filesystems and the C compiler and C library, 
root was kept to a minimum size (usually about 8 Megabytes) so the chances of 
corrupting it were small. However, even with minimal sizing, it contained 
enough utilities to rebuild a corrupted machine. 
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By moving nearly all of the executables to /usr and mounting /usr automati¬ 
cally at boot time, the problem of choosing which executables should be avail¬ 
able in single-user mode has been solved. 

However, to mount the /usr filesystem, a few executables are needed in the 
root partition. The /sbin directory holds the necessary executables to mount 
/usr at boot time. The r c. boot shell script, which is executed at boot time 
by init, mounts the /usr filesystem, then checks both the root and /usr 
filesystems. 

The following table lists the executables that have been moved from /etc to 
/usr/etc. The Symbolic Link category shows if there is a S)mibolic link 
between the original name and the new name by the use of an arrow (=>). If 
there is no arrow, there is not a symbolic link between the old and the new name. 
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Table 2-4 Executables Moved From /etc to /usr/etc 


Original Name Symbolic Link 

New Name 

/etc/arp => 

/usr/etc/arp 

/etc/biod 

/usr/etc/biod 

/etc/chown ^ 

/usr/etc/chown 

/etc/clri => 

/usr/etc/clri 

/etc/chroot => 

/usr/etc/chroot 

/etc/cron => 

/usr/etc/cron 

/etc/dkinfo => 

/usr/etc/dkinfo 

/etc/dmesg => 

/usr/etc/dmesg 

/etc/dximp 

/usr/etc/dump 

/etc/fastboot => 

/usr/etc/fastboot 

/etc/fasthalt => 

/usr/etc/fasthalt 

/etc/fsck => 

/usr/etc/fsck 

/etc/fsirand 

/usr/etc/fsirand 

/etc/getty 

/usr/etc/getty 

/etc/halt 

/usr/etc/halt 

/etc/ifconfig => 

/usr/etc/ifconfig 

/etc/in.rlogind 

/usr/etc/in.rlogind 

/etc/in.routed 

/usr/etc/in.routed 

/etc/in.rshd 

/usr/etc/in.rshd 

/etc/inetd 

/usr/etc/inetd 

/etc/init 

/usr/etc/init 

/etc/in.rexecd 

/usr/etc/in.rexecd 

/etc/link => 

/usr/etc/link 

/etc/mkfs => 

/usr/etc/mkfs 

/etc/mknod => 

/usr/etc/mknod 

/etc/mount 

/usr/etc/mount 

/etc/ncheck => 

/usr/etc/ncheck 

/etc/newfs => 

/usr/etc/newfs 

/etc/nfsd 

/usr/etc/nfsd 

/etc/portmap 

/usr/etc/portmap 

/etc/pstat => 

/usr/etc/pstat 

/etc/reboot 

/usr/etc/reboot 

/etc/renice =» 

/usr/etc/renice 

/etc/restore => 

/usr/etc/restore 

/etc/rpc.lockd 

/usr/etc/rpc.lockd 

/etc/rpc.statd 

/usr/etc/rpc.statd 

/etc/shutdown 

/usr/etc/shutdown 

/etc/umount => 

/usr/etc/umount 

/etc/update => 

/usr/etc/update 

/etc/unlink 

/usr/etc/unlink 

/etc/ypbind 

/usr/etc/ypbind 

/etc/ypserv 

/usr/etc/ypserv 
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The following table lists the new names of other files and directories. It states 
whether or not they have a symbolic link from the original name to the new 
name, and whether it is a file or directory. 


Table 2-5 Other Files and Directories 


Type 

Original Name 

Symbolic Link 

New Name 

directory 

Aisr/adm 

=> 

/var/adm 

directory 

Aisr/preserve 


/var/preserve 

directory 

/usr/tmp 

=> 

/var/tmp 

directory 

/usr/spool 

=> 

/var/spool 

file 

AisrAib/sendmail.cf 


/etc/sendmail.cf 

file 

Aisr/lib/aliases 


/etc/aliases 

file 

AisrAib/crontab 


/var/spool/cron/crontab/root ** 

directory 

Aisr/boot 

=> 

/usr/kvm/boot 

directory 

Aisr/stand 

=> 

/usr/kvm/stand 

directory 

/usr/mdec 

=> 

/usr/kvm/mdec 

** Can also have: 
/etc/spool/cron/crontabs/usemame 
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2.12. Installation The type of installation roadmap you follow depends on whether or not you have 

Roadmaps a customized environment that you want to preserve. If you are installing a sys¬ 

tem for the first time, then you do not have a customized environment to save. If 
you are re-instaUing a system, you will want to save your customized environ¬ 
ment. 

The following roadmaps list the recommended installation procedures in sequen¬ 
tial order. It is advised that you adhere to this sequence for a successful installa¬ 
tion. 


ROADMAP: Installing a New 
System 


Pre-installation Procedures 


1. Plan disk space (number of clients, services offered etc.). This information 
is covered in the next chapter. Getting Started. 


Installation Procedures 


Post-installation Procedures 


2. Load the bootstrap program. 

3. CopyMUNIX. 

4. BootMUNIX. 

5. Format disk using format. 

6. Copy the miniroot. 

7. Boot the miniroot. 

8. Run suninstall. 

9. OPTIONAL: Install a small pre-configured kernel, if applicable. See the 
Post-installation Procedures chapter for more information. 

10. Boot the system. 

1. Install patch tapes if applicable. 

2. Configure a custom kernel, if you did not install a small kernel. 

See the Post-installation Procedures chapter for more information. 

3. Edit system specific files such as / et c/passwd. 
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ROADMAP: Re-installing an 
Existing System 

Pre-installation Procedures 


Installation Procedures 


Post-installation Procedures 


1. Obtain hardcopy of the disk layout and appropriate network information. 
See, Getting Started for more information. 

2. Preserve the customized environment. 

See, Getting Started for more information. 

3. Halt aU clients. 

4. Immediately before beginning the installation, shutdown the machine to 
single-user mode. 

5. Perform full dumps of all filesystems. 

1. Load the bootstrap program. 

2. CopyMUNIX. 

3. BootMUNIX. 

4. OPTIONAL: Format disk using format. 

5. Copy the miniroot. 

6. Boot the miniroot. 

7. Run suninstall. 

9. OPTIONAL: Install a small pre-configured kernel if applicable. See the 
Post-installation Procedures chapter for more information. 

10. Boot the system. 

1. Install patch tapes if applicable. 

2. Configure a custom kernel, if you did not install a small kernel. 

See the Post-installation Procedures chapter for more information. 

3. Edit host or passwd files. 

4. Recustomize the environment. 

See the Post-installation Procedures chapter for more information. 
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Getting Started 


3.1. Introduction In the previous chapter, you were given the necessary background information 

for an overview of an installation. This chapter covers the following procedures: 

1. Determining network information necessary for the installation. 

2. Planning disk space. 

3. Completing pre-instaUation procedures. 

4. Copying MUNIX. 

5. Formatting the disk. 

6. Copying and booting the miniroot. 

Read through the entire chapter before beginning the procedures. Completing 
the tasks in sequence will help insure a smooth and successful installation. 


3.2. Planning Disk Space Planning disk space prior to starting the installation is essential for creating the 

proper environment Due to the filesystem reorganization in 4.0, you may want to 
partition the disk differently than the 3.x layout In SunOS 4.x, the client root 
and swap areas have changed so they are treated as regular NFS filesystems. To 
accommodate this change, it is suggested that you arrange the disk to provide 
areas for client root and swap. For more information, see the System and Net¬ 
work Administration manual. 

For an example of SunOS disk partitioning see the Disk Structure section that 
follows. 

The following table is an example of the allocation of space on an 840 cylinder 
disk. This table is only an example. Your system may require different space 
allocations. 
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Disk Structure 


Table 3-1 Space Allocation For an 840 Cylinder Disk 


Partition 

Cylinders 

Description 

xyOa 

25 cyls 

/ 

xyOb 

49 cyls 

(swap) 

xyOc 

840 cyls 

(entire disk) 

xyOd 

137 cyls 

/export/root 

xyOe 

173 cyls 

/expoil/swap 

xyOf 

161 cyls 

/export/exec 

xyOg 

195 cyls 

/usr 

xyOh 

100 cyls 

/home 


The basic unit of the disk is the sector. Sxm disk sectors contain 512 bytes of 
data space. Sectors radiate outwards from the center of the disk. The data space 
is furtoer divided into concentric circles, called tracks, which pass through all the 
sectors on the disk surface. On drives with multiple disk platters, tracks which 
occupy the same location on two or more disk surfaces are referred to as 
cylinders. 

Each disk has a maximum of eight hard partitions. By convention, they are 
labelled "a" through "h". These hard partitions create separate physical sections 
on the disk. Note that disks do not have to use all of the available hard partitions. 
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Figure 3-2 Disk Diagram: Cylinder 
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The following table illustrates the SunOS standard for disk partitioning. You 
have the option of changing all but the root partition in suninstall. To change 
the size of the root you must use format. 

If you are installing a Sun-4 woikstation, you wiU need to increase the size of the 
‘‘b’ ’ partition. The “b” partition can be increased using suninstall but not 
decreased. By Sun standard, “b” is normally the swap partition. For mote 
information, see Why Format? in Chapter 4 of this manual. 


Table 3-2 Standalone Disk Partitioning Standards 


Partition 

Description 

Type 

a 

/ (root) 

suninstall default 

b 

swap 

suninstall default 

c 

entire disk 

suninstall default 

d 

— 

unassigned 

e 

- 

unassigned 

f 

- 

unassigned 

g 

/usr (system level files) 

suninstall default 

h 

/home (home directory, free hog space) 

suninstall default 


Table 3-3 

Server Disk Partitioning Standards 


Partition 

Description 

Type 

a 

/ (root) 

suninstall default 

b 

swap 

suninstall default 

c 

entire disk 

suninstall default 

d 

/export/root (client root area) 

suninstall default 

e 

/export/swap (client swap area) 

suninstall default 

f 

/export/exec (executable files) 

user select 

g 

Aisr (system level files) 

suninstall default 

h 

/home (home directory, free hog space) 

suninstall default 


Disk Planning Issues This section covers issues you should be familiar with before planning your disk 

space. The following section covers recommendations for size and usage of vari¬ 
ous disk partitions. 

□ SunOS 4.x requires the following disk space for storage: 

Sun-4: Minimum -19.1 Mb, Maximum - 65.93 Mb 

Sun-3: Minimum - 18.1 Mb, Maximum - 60.71 Mb 

Sun-2: Minimum -18.1 Mb, Maximum - 59.62 Mb 

The minimum disk usage is the sum of root and usr files. The maximum 
disk usage is when all optional software is selected during installation. 

□ Asa standalone system, you will need enough space for the basic operating 
system software plus any application software for your site. This space is 
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located in the partition mounted as /usr. The Read This First that accom- 
panies the tapes includes a list of available software packages and their 
respective sizes. 

o Asa server, the space required depends on the number of clients served and 
the resources provided to each (i.e. boot, root, /home, etc.). 

□ It is strongly recommended that you allocate a separate disk partition for 
/ var. Allocate space to this partition based on your experience with adm, 
tmp, and spool requirements in previous releases. If you do not create a 
partition for / var, aU spooling will occur in the root filesystem. For more 
information on the / var partition, see the Sizing Disk Partitions section 
that follows. 


□ The fi'ee hog partition is the partition whose size is reduced when /usr and 
/export/exec run out of space, suninstall automatically takes space 
from the free hog partition if /usr and /export/exec run out of space 
while you are selecting software categories. The default for the free hog par¬ 
tition is /home, which is typically the “h” partition. 


□ 


□ 


The root / partition is no longer available as an option for the free hog 
partition. You must select from partitions [d], [e], [f], and [g]. Remember, 
that the /usr and / export/exec partitions cannot be used as the free 
hog partition. 

By Sun convention, every disk drive must have a ’c’ partition which starts at 
sector zero (0) and is the full size of the disk. AU format default labels 
foUow this convention. Please note that if the ’c’ partition is not designated 
correctiy on a drive, suninstall wiU not recognize it and it wiU not be 
displayed on the Disk Form. 




□ It is permissible to expand the size of the ’b’ (swap) partition in suninstall. 
If you want to reduce the size of the ’b’ partition, you must use format 
running from MUNIX. 




The first five steps in the Pre-installation Procedures section that foUows help 
you with planning disk space for your system. 
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Sizing Disk Partitions This section gives usage and recommendation for size of the following disk parti¬ 

tions. 

All Systems: 

/ (root) 

The default root filesystem size is approximately 8 megabytes. This 
should be sufficient for most applications. 

swap 

The default swap partition size is approximately 16 megabytes. This is 
sufficient for general applications. Certain applications, such as use of a 
color monitor or having extra memory installed, will require more swap 
space. 

Some installations running non-memory intensive applications configure 
swap as twice the size of physical memory or 16 megabytes, whichever is 
greater. 

You can increase the size of the swap partition using suninstall, but it can¬ 
not be decreased. For more information, see the Why Format? section in 
Chapter 4 of this manual. 


usr 

The /usr partition is automatically expanded by suninstall to accomodate 
'w' the optional software selected from the Disk Form. The extra space is taken 

from the free hog partition. 

When suninstall automatically sizes the /usr partition stealing from the 
free hog partition, it results in an extremely full /usr partition. It is advised 
that you allow suninstall to size the partition, and then return to the Disk 
Form and add 8 megabytes or 10%, whichever is greater. This added space 
is necessary to allow room for configuring a kernel. If you plan on adding 
any custom or unbundled software to the /usr partition, you must also allo¬ 
cate the required space to accomodate the added software at this time. This 
is in addition to the 8 megab 5 ^es (or 10%) already allocated. 

Recommended: 

/var 

The / var directory tree is intended as a repository for files that vary in size. 
The following files are links to /var in SunOS 4.x: /usr/adm, 

/usr/tmp, /usr/ spool. Database files on Yellow Pages servers are 
kept in /var/yp. 

As installed by default, / var is a plain directory in the root ( / ) filesys¬ 
tem. This design risks the possibility of rapidly filling the root filesystem 
during normal system operation. For this reason, it is suggested that you 
allocate a separate disk partition for / var. Size this partition on your prior 
experience with / usr/adm, /usr/tmp, and /usr/spool requirements 
V. - in previous releases. 
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Servers: 

/export 

/ export is the default name on a server for the directory tree used to sup¬ 
port diskless clients. It includes the following three primary subdirectories: 

□ /export/exec: This directories’ partition is expanded by suninstall 
as optional software is selected for client systems of architectures dif¬ 
ferent fiom that of the server itself. As in the case of /usr, it is recom¬ 
mended that you add additional space to the partition to accommodate 
kernel configuration and any additional software. 

Every server has a symbolic link ( /export/exec/ARCH ) to its 
own /usr partition. 

□ /export/root: This is the default name on a server for the directory 
used to hold diskless client root partitions. Allow a minimum of 2 
megabytes for each diskless client. 

□ /export / swap: This is the default name on a server for the directory 
used to hold diskless client swap partitions. The suggested size for a 
client swap area is 16 megabjdes. This is only a suggestion, require¬ 
ments are system and application dependent" To estimate the size 
requirement for this partition, add together the swap sizes required for 
the diskless clients that are supported by the server and then add 6% 
more to this total to accommodate filesystem overhead. 

o When installing a heterogeneous server, it is suggested that 

/ export/root and / export/ swap each be made a disk partition. 
Additionally, heterogeneous servers should have an /export partition 
which will hold the /usr files for the heterogeneous clients. 


3.3. Determining Network A network is a group of machines connected together so they can transfer infor- 

Information mation. Machines attached to the network are called hosts. 

Network Classifications Networks are typically categorized according to the physical distance that they 

cover. The local area network (LAN) covers a medium range and the wide area 
network (WAN) covers a wide range. 

Sun Workstations use the Internet Protocol (IP) family for communication. Each 
workstation must have its own unique IP address in order to communicate. IP 
addresses are composed of a network number and a host number on the affiliated 
network. 


0 ^ 


IP network numbers are assigned by the DDN Network Information Center at 
SRI International, 333 Ravenswood Avenue, Menlo Park, California 94025. You, 
or your system administrator, can assign the hostnumbers on your network. 


^sun 

microsystems 
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Choosing a Network Number When you apply for an official network number, you will be asked what class of 

Class network number you need. The type of class you choose determines how much 

of the 32 bit IP address space you will have to assign addresses to your hosts. 

IP addresses are expressed in the general form of four octets; p.q.r.s, for example; 
192.9.101.22. 

The possible network number classes are; 

Qass A 

Network numbers are one byte (8 bits) long. 

Class B 

Network numbers are 2 bytes (16 bits) long. 

Qass C 

Network numbers are 3 bytes (24 bits) long. 

There are quite a few more class C network numbers than class A network 
numbers, but the class C network numbers don’t allow for many hosts. The ori¬ 
ginal plan was that there would be few very large networks, a moderate number 
of medittm-size networks, and a lot of small businesses with small networks. 

The following table illustrates the distinctions; 


Table 3-4 Network Classifications 


Class 

Range of First Octet 

Network 

Host 

Addresses Per Network 

A 

1-126 

P 

q.r.s 

16777214 

B 

128 -191 

p.q 

r.s 

65534 

C 

192 - 223 

p.q.r 

s 

254 


In general, you are expected to choose the lowest class that you anticipate will 
provide you with enough addresses to handle your growth over the next few 
years. Organizations that have computers in many buildings probably need a 
class B address, assuming they are going to use subnetting. If an organization is 
going to require many separate network numbers, a class C address is advised. 
Qass A networks are normally used only for large public networks and for a few 
very large corporate networks. 

Required Network 

Information for Installation 


Hardware configuration must be completed first; each machine must have Ether¬ 
net controller hardware, and be ‘plugged in’ via a transceiver to a common Ether¬ 
net cable. For Ethernet hardware configuration instructions see the Hardware 
Installation manual for your machine model. 

Before proceeding with the installation, you must obtain basic information about 
your system’s place in the network. Some of the information items, like machine 
name, are aihitrary, and others are determined by hardware. 


If you are installing several machines linked by a local network, part of the 
installation process includes basic network configuration. This section covers the 
required basic information regarding the configuration of your network. For more 
information, see the System and Network Administration manual. 


microsystems 
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Gathering Network Information Prepare a sheet of paper with the following information. See Appendix D for an 

installation woricsheet to help with this task. 

The following items are requested during installation. It is recommended that 
you gather this information now. 

□ Internet Address 

The full Internet (IP) address for each workstation you are setting up 
whether it is a server or a client. A machine’s IP address consists of the net¬ 
work number followed by the host number. 

You obtain your network number from the DDN Netwoik Informatihon 
Center (NIQ and assign host numbers uniquely to machines on your net¬ 
work. IP addresses for installed machines are located in the YP hosts map or 
the local / et c / ho st s file. See the System and Network Administration 
manual for more information. 

□ Ethernet Address 

The hardware Ethernet address of each client machine if you are installing a 
server/clients configuration of machines. This address is a 6-byte hexade¬ 
cimal value with bytes separated by colons. Your Ethernet address is 
displayed when you turn on your workstation. 

□ Hostname or Machine Name 

The hostname of each workstation you are installing. Hosmames are 
allowed up to 32 alpha/numeric characters, however, it is recommended that 
they be as brief as possible. All alphabetical characters in a hostname must 
be lower case. The hosmame cannot begin with a digit The use of special 
characters should be avoided. Each machine in a network is assigned a host- 
name. 

On an installed machine, you can use the hostname command to deter¬ 
mine the hostname. 

□ Domain Name 

If you are running yellow pages, you need to know the yellow pages domain 
name of the group of workstations you are installing. 

A Yellow Pages domain is typically made up of a group of machines admin¬ 
istered in common. The domainname command can be used to discover 
the domain name of installed machines. You must have a domain name if 
you plan to use the Yellow Pages. 


Items of Note □ You must have distribution tape sets for server and client architectures if you 

are installing a heterogeneous server. If you want this server to support 
Sun-2 Sim-3, and Sun-4 hardware, you must have Sun-2, Sun-3, and Sun-4 
distribution tapes. 

□ Clients of a different architecture can be added at a later date. 


wsun 

XT microsystems 
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" □ On systems with more than one Ethernet interface, you must configure the 

second Ethernet interface manually. 

□ The domain name is always necessary if you are running the yellow pages. 


□ To obtain each client’s machine hardware Ethernet address use the following 
steps: 

1. If the system is running, bring it down in the following way: 



2. At the > prompt, type the following: 



3. The system responds in the following way. 





Copy down the six-byte Ethernet address that is displayed. You will need it for 
the installatioa 


3.4. Pre-installation Issues If you are going to install a heterogeneous server or are define multiple swap par¬ 
titions in your installation, pay close attention to this section. 

Installing a Heterogeneous When you install a heterogeneous server, you will have to define an /export 

Server partition for the client architecture executable files that are different from that of 

the server architecture. /export /execclient_ARCH is mounted by the 

clients as /usr. You define this partition in the Disk Form in suninstall. When 
software is selected later in the installation, suninstall expands the /export 
partition as needed. 

If you do not define the /export partition in the Disk Form, suninstall will 
place /export/execclient ARCH in the root partition. In this case, sunin¬ 
stall automatically expands the root partition to accomodate the heterogeneous 
client binaries. Changing the size of the root partition is not allowed during 
suninstall and the installation will fail. 
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Multiple Swap Partitions 


3.5. Pre-installation 
Procedures 


If you are going to define multiple swap partitions during installation, be aware 
of the following critical issues: 

□ Do not use the ‘a’ partition of any disk for swap 

The label information for each disk is located on cylinder 0. Filesystem 
structures follow this rule and preserve the disk label when when they are 
created with newf s (8) or mkf s (8). Partitions designated for swap, 
however, do not preserve the contents of their first cylinder. For this reason, 
if a swap partition is designated to begin at cylinder 0 (typically the ‘a’ parti¬ 
tion), the disk label information is destroyed. You can prevent this in one of 
the following ways: 

1) Use the ‘a’ partition of each disk for a filesystem and designate another 
partition for swap. 

2) Define partition ‘a’ as a single cylinder that is an unused partition (start¬ 
ing cylinder 0, length of 1 cylinder). Then start the swap partition 
beginning at cylinder 1. 

□ Defining multiple swap partitions to the kernel 


To build a 4.x kernel with its root partition on partition xyOa and swap par¬ 
titions on xyOb and xylb, use the following config line: 



For more in-depth information on configuring multiple swap partitions and 

files, see the System and Network Administration manual and the 

swapon(8) manual page. 

If you are installing 4.x on a system running 3.x, the following list of procedures 
prepare you for starting the installation. These steps help return your environ¬ 
ment to the state it was in prior to installation: 

These procedures are applicable only if you are re-installing an existing system. 

1. Obtain hardcopy of the following: 

□ Output from mount -p. This serves as a guide for customizing 
/etc/fstab after installation is complete. 

□ Output from dkinf o command as a starting point in planning disk lay¬ 
out. dkinf o output shows existing disk layout. Due to the new 
filesystem in 4.x, you will not be able to use this information directly. 

□ List of clients and their IP addresses which are mounting their root 
and swap, or booting from this server. 

□ Amount of swap space for each client mounting its swap from this 
server. 

o Architecture for each client mounting its root or booting from this 
server. 


microsystems 
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a Current kernel configuration files for each client for when the kernels 
are built after installation. 


A GENERIC kernel is provided for each workstation architecture. These 
kernels include support for all Sun peripherals and for all kernel ser¬ 
vices. As a result, the GENERIC kernels are larger than necessary for any 
particular woikstation, resulting in decreased workstation performance. 
It is highly recommended that you either use a small pre-configured ker¬ 
nel or that you configure a custom kernel to support only those devices 
and services required for your woikstation. See the Post-installation 
Procedures chapter of this manual for more information on small pre¬ 
configured kernels and custom kernel configuration. 

o Copy of old /etc/fstab, /etc/crontab, and /etc/passwdfor 
integration into new files created by the installation. 

□ The name and IP address of the machine being upgraded. 

□ The name and IP address of the second Ethernet interface if applicable. 

2. Fix YP master passwdmap. Home directories in 4.x changed from 
/usr/servername/username to 

/home/servername/username, though this can vary by site. 

''w 3. Make a list of all the mount points and links that have been added to / and 

/usr. This allows you to re-create them after file installation. 

4. Optional: Copy files from /usr/local, /usr/spool/mail, and other 
locally created directories under /usr to tape or another disk. This facili¬ 
tates re-customization after installation. 

Note: You have the option of restoring the environment from dumps to tape 
instead of performing this step, but this may require more woik. 

5. Optional: Save copies of /etc/passwd, /etc/licenses, 
/etc/printcap, /usr/lib/aliases (3.x) and /etc/aliases 
(4.x), and other customized files. 

6. Halt clients. 

7. Run f sck -p. This program cleans up the filesystem and assures its 
integrity. 

8. Perform full dumps of filesystems that will be changed by the installation. 
For example but not limited to, /, /usr, client root. 

3.6. The Abort Sequence During the course of an installation, you may want to tenninate a procedure. It is 

always good to know about an escape mechanism for a situation before it arises. 
For this reason, the abort sequences are listed below. Familiarize yourself with 
the one that pertains to your environment. Your keyboard type is displayed when 
you power up your system. 
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To return to the PROM monitor at any time during installation, you can type 
what we call an abort sequence on your keyboard. The abort sequence usually 
consists of two keys typed in sequence; the first key is held down while the 
second key is typed. The keys vary with Sun Woricstation model and keyboard 
type: 

□ If your Sun-1 keyboard has a [ SET-UP 1 key, the abort sequence is 
t SET-UP-a I (hold down the (SET-UP 1 key while typing ‘a’)- 

□ If your Sun-1 has an IERASE-EOFI key, the abort sequence is 

I ERASE-EOF-a I (hold down the I ERASE-EQF 1 key while typing ‘a’). 

□ On a Type 2 keyboard, type 1 Ll-a 1 (hold down the 1 LI I key in the upper¬ 
most left-hand comer while typing ‘a’). 

□ On a Type 3 keyboard, type (Ll-a I (This is the same as the Sun-2 keyboard.) 

□ On a Type 4 keyboard, type I Ll-a I 

□ On a standard terminal (if it is the console) the I BREAK I key generates an 

abort. 



Pressing ICTRL-CI stops the installation and returns to the miniroot. The instal¬ 
lation can then be restarted without having to reload the miniroot. 
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Beginning the Installation 


4.1. Introduction This section covers the following procedures. These procedures are the first 

steps of the installation. After you have completed the following procedures, you 
will be ready to start suninstall. 

1. Loading the boot st rap program. 

2. Copying MUNIX. 

3. Booting MUNIX. 

4. Formatting the disk. 

5. Copying the miniroot. 

6 . Booting the miniroot. 

The following terminology section explains each of these programs and what you 
accomplish by running them. 


4.2. Terminology 


□ bootstrap program 

Is a program that gives the system enough intelligence to find, load, and exe¬ 
cute a program. You must load the bootstrap program first in order to 
load MUNIX, standalone copy, or vmunix. 

□ format 

Is a program that allows you to format, label, repair, and analyze disks on 
your system. 

o miniroot 

Is a small UNIX kernel and filesystem that when in place, allows you to use 
basic filesystem commands and install the comprehensive UNIX using 
suninstall. 

□ Copying the miniroot 

When you copy the miniroot, you copy a reduced size UNIX filesystem from 
tape to the swap area of the disk. 



47 
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□ Booting the miniioot 

When you boot the miniroot, you boot its vmunix. Once vmunix is nuining, 
you can run suninstall. 

□ Swapping an area on the disk that SunOS uses as a scratch pad. 

□ MUNIX 

MUNIX is a small version of the operating system that is loaded from tape or 
over the network directly into memory rather than onto disk. It is used when 
major disk operations such as formatting the disk or changing the size of the 
root or swap partitions. 

4.3. Loading the Bootstrap This section covers mounting the distribution tape on your tape drive, and using 
Program the PROM Monitor to load the bootstrap program from tape. As mentioned 

above, the bootstrap program is used to load other programs from tape into 
memory. 

The steps for this procedure are tailored for a basic system structure. Read 
through this entire section before starting; this precaution allows you to deter¬ 
mine if these steps match your system needs. 

The Distribution Tape The software needed to load the operating system is contained on a set of half¬ 

inch magnetic tape reels or quarter-inch tape cartridges. The number of tapes in 
the set varies wito each release. See the READ THIS FIRST document which 
accompaiues the tapes for a complete listing of the files on the distribution tape. 


To Mount the Tape: 



Step 1: Turning on the 
Workstation 


If you are re-instaUing an existing system, you need to shut down the machine to 
single user, do a fuU dump of aU filesystems, and then halt the system. To halt 
the system, become super-user and type the command: /etc/halt. 
Remember to halt aU diskless clients first if the system is a server. 

A full dump of all filesystems is strongly recommended before you halt the 
system. 

Use the following steps to mount the distribution tape. 

Turn on the Sim Workstation you are installing. 

The PROM monitor displays its power-up baimer, something like the example 
below. The machine begins to auto-boot. 
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Sun Workstation^ modeljype, keyboardjype 

ROM Rev somejiumberJdBytes memory installed 

Serial ^somejtumber, Ethernet address xx:xx:xx:xx:xx:xx 

Auto-boot in progress ♦ ♦ , 
i Ll-a I 

(or appropriate abort sequence) 

Abort at somejiddress 


See Chcqjter 3 in this manual for the appropriate abort sequence for your system. 

Step 2: Stopping Auto-boot Stop the auto-boot immediately by typing the appropriate abort sequence for 

your machine (abort sequences are described in the previous chapter). When you 
abort the auto-boot, you return control to the monitor, and it displays its prompt 
(>). 

Step 3: Mounting the Tape Moimt tape 1 of your full installation tape set. 



Before mounting the tape, check your tape drive hardware manual. With some 
tape drives, if you insert the tape incorrectly, it becomes jammed and is difficult 
to remove. 


If you have any questions about your tape drive, see the subsystems chapter in 
the Hardware Installation manual for your machine. 

Remember to substitute the proper device abbreviation for your tape controller 
for tape. The following table provides a list of possible tape device abbrevia¬ 
tions. 


Table 4-1 Tape Controller Abbreviations 


Abbreviation 

Tape Controller 

ar 

Archive 1/4” 

St 

SCSI 

mt 

Tapemaster 1/2” 

xt 

Xylogics472 1/2” 


For more information on device abbreviations or conventions, see the SunOS 
Device Names section in Chapter 2. 


To Load the Bootstrap 

Program: 

To install SunOS using a local tape drive, boot the bootstrap program from the 
tape. The following example uses the stO tape device. 


r > 

>b srt)(0,0,0) 
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When you type the command, the monitor echoes it back to you. If you load the 
boot program fiom st, you receive the following display; 


r 


>b st(0,0,0) 


Boot: St (0^0^0) 


Boot: 



j 


4.4. Formatting the Disk 


Why Format? 


format is the program you run to format, label, repair, and analyze your disk. 

In particular, it is necessary to run format if your target system disk has been 
corrupted or if it was purchased from a third party vendor. In both cases, you 
need to format and label the drive before installing SunOS. 

If your disk was purchased from Sun, it was formatted and labelled at the factory. 
However, it is still recommended that you reformat the entire drive as it insures 
that any head movement that occurred during shipping will not affect the perfor¬ 
mance of the new disk. 


If you want to change the root partition, or decrease the size of the swap parti¬ 
tion, you need to create a partition table and relabel the disk using format 
before you copy the miniroot. Other partition sizes can be changed in suninstall. 
For information on how to create a partition table, see the System and Network 
Administration manual. 


o 


If you are re-installing a system that is already ranning SunOS, you do not need 
to run format. 



FoUow the procedures in this section with extreme care. Using format to res¬ 
tructure your disk partitions, in certain cases, can cause all existing data to be 
erased. Before proceeding, complete the following steps: 

1. Make at least one backup of the disk you intend to format if the disk was 
previously in use. 

2. Make sure there is a minimum of four megabytes (4 Mb) of memory. This is 
the amount required for MUNIX. 


What is MUNix? MUNIX is a version of the SunOS that can be loaded from tape and resides 

entirely in virtual memory. It is not loaded or swapped from a disk and therefore 
is a useful tool if your local system disk is unformatted, corrupted, or requires 
reformatting or labeling. 
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If you do not need to format your disk, you can go directly to the Copying the 
Miniroot section. 


MUNIX has the following optional argument for creating entries on the disk: 
The [ -a ] option 

allows you to define where root and swap reside. If you do not specify 
this argument, the Sun default is used. 

If you need to modify and save files tmder MUNIX, you must perform the addi¬ 
tional step of saving the files to a scratch tape before exiting MUNIX. This is 
required due to the fact that MUNIX stores all its "files" in volatile storage (i.e. 
ramdisk). 


Copying MUNIX and Running The following example shows how to copy MUNIX and run format to format 
f o rma t your disk. 


Example Variables The following variables are used in the following example. All the variables are 

displayed in italics. When performing this procedure on your own system, sub¬ 
stitute the proper device names for your environment. 

o Installing xyO (Xylogics 451) as your system disk. 

□ The target disk is a Fujitsu 2333 

□ Loading from a 1/4" tape, st device type. 

□ You have mounted the tape and loaded the bootstrap program. See the 
Loading the Bootstrap Program section for more information. 

Step 1: Copying MUNIX To copy MUNIX, use the following method: 
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Boot ;5^(0,0,4) 

Stz&: some number + some number bytes 

SunOS Release 4.0,3 (MUNIX)#li Thurs Mar 2 20:S4:17 PST 1989 

Copyright(c) 1989 Sun Microsystems, Inc. 

mem « 4a96K (0X400000) 

avail mem “ 3186688 

Ethernet address « 8:0:20:07a:55 


disk and tape drive information 


ethernet controller information 


init ram disk from device (st%d[a'“h] sd%d[a'“h] ft%d[a~h3) 

rd: reading 176,8192 byte blocks,... 

WARNING: clock gained 7 days - CHECK AND RESET THE DATE! 
root on rdOa fstype 4.2 
Tape file number? 5 

swap on nsOa fstype spec size 1216K 
dump on nsOa fstype spec 


sun 
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spec is a special partition type used for the swap partition. 

4J, is a UNIX filesystem structure type. 

rdOa is a notation for ram disk. 

nsOa is a notation meaning ’no swap’. 

stO is for either QIC-24 or QIC-11 tape formats. 

stl is for the second tape drive. 

st2 is for the third tape drive. 

st3 is for the fourth tape drive. 



Step 2: Starting format 



Start format and select the disk to format in the following way: 



The displayed DISK SELECTIONS reflect those disks installed on your system. 
Choose the disk that you want to format. 


^sun 

Xr micfosystems 


Revision A, of 25 April 1989 







54 Installing the SunOS 4.0.3 





If the "AVAILABLE DISK SELECTIONS" field does not display one or more of 
the disks physically installed on your system, make the disk device in /dev in 
the following way. 




# cd /dev 


# MAK£DBV device 


_ 



See SunOS Device Names in Chapter 2 of this manual for a list of possible device 
names. 



The screen should respond that the disk is formatted and a defect list is present. 
Disks from Sun should ALWAYS give you this response. If you do not see this 
message, something is wrong and you should immediately exit format and use 
diagnostics to locate the problem. 


Step 3: Comparing the Defect 
List 


Compare the defect list with the hard copy of the manufacturer’s defect list. It 
should contain aU the defects on the hard copy list. The manufacturer’s defect 
list is typically paperwork shipped with the drive. If any of the defects are miss¬ 
ing, use the add command to add them to the defect list before proceeding. 

To print a working copy of the defect list and transfer it to a file, use the follow¬ 
ing method. 
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fomat> defect 
<CR> 

<CR> 

DEFECT MENU: 

restore 
original - 
extract 
add 

delete ~ 
print 
dump 
load 

commit - 
quit 

defect> print 
num cyl 
1 11 

2 21 

3 106 


set working list = current list 

extract manufacturer's list from disk 

extract working list from disk 

add defects to working list 

delete a defect from working list 

display working list 

dump working list to file 

load working list from f 

set current list = working list 


hd 


bfi 

31858 

14820 

27403 


len 

4 

4 

4 


sec 


41 811 0 27738 6 

42 820 4 4502 3 

total of 42 defects. 

defect> doxap 

Enter name of defect file: 2333_defs.033537 
defect file updated^ total of 42 defects. 
defect> q 
format> q 


If your disk was purchased from a third-party or is missing its defect list, you can 
use the [extract] option of the defect subcommand within format to 
examine the disk and build the defect list based on the defects that have been 
repaired. If you have a third-party disk that’s brand new, you can use the [ori¬ 
ginal] option of the defect subcommand within format to read the 
manufacturer’s defect list that comes with all SMD drives. For more information 
on these commands, see the System and Network Administration manual. 

Step 4: Saving the Defect List Save the defect list file using the tar utility. 


Mount a writable scratch tape to which to save the defect list. DO NOT try 
to save the defect list on the boot tape. If you save the defect list with the boot 
tape still mounted, you will destroy the boot tape. 

The defect list is saved as a precaution in case it is destroyed at some time in the 
future. This saves you from retyping it manually. 
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......V 

*** Load a scratch tape before entering *** 

*** the next command. *** 

# tar cvf, /dev /TStO 2333_defs.033537 



You may need to make the tape device, especially if you are using 1/2" tape dev¬ 
ice. To do this, use the following method. 



See SunOS Device Names in Chapter 2 for a list of possible tape devices. 



The defect file name in the example ’2333_defs.033537’ reflects the model of the 
disk (Fujitsu 2333) and the serial number of the disk (033537). This is a recom¬ 
mended procedure since it allows you to easily match the defect file with the 
correct disk. If the serial number of your disk is not readily available, you can 
use another unique identifier. 


Step 5: Starting format 


Start the format program. 



If you want to change the size of the root or swap filesystems, it is recom¬ 
mended that you do it at this time. You cannot change the size of the root 
filesystem (“a”) in suninstall. You can increase the size of the swap filesystem 
(‘ ‘b’ ’) in suninstall but you cannot decrease it. 
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# format 

Searching for disks...done 
<CR> 

<CR> 

AVAILABLE DISK SELECTION: 

0. xdO at xdcO slave 0 
Specify disk (enter its number): 0 
selecting xyO <type unknown> 

Foimiat Menu: 
disk 
type 

partition 
current 
format 
repair 
show 
label 
analyze 
defect 
backup 
quit 

format> type 

0. Fujitsu*-2351 Eagle 

1. Fujitsu"M2333 

2. Fujitsu-2361 Eagle 

3. CMD EMD 9720 

4. Other 

Specify disk type (enter its number): 1 
selecting xdO <Fujitsu-M2333> 


- select a disk 

- select (define) a disk type 

- select (define) a partition table 
describe the current disk 

- format the disk 

-- repair a defective sector 

- show a disk address 

- label the disk 

- surface analysis 

- defect list management 

- search for backup labels 


Step 6: Running format 


Run format. 

format> format 

Ready to format. Formatting cannot be interrupted 
and takes a long while. Continue? y 
Beginning format. The current time is 
Wed Sep 2 16:58:05 1987 

Formatting.,.done 

Verifying media,.. 

pass 0 - pattern = 0xc6dec6de 
pass 1 - pattern - 0x6db6db6d 
Total of 0 defective blocks repaired. 
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The verification of the fonnat can take up to one hour depending on the architec¬ 
ture of your system. It is recommended that you allow this analysis to complete 
to verify the integrity of the media. 

Once the verification is complete, the disk is formatted. The default values for 
the bounds of the format command cause the entire drive to be reformatted. 
Also, by leaving the surface analysis parameters in their default state, 2 passes of 
analysis are automatically run on the disk when format completes. 


Step 8: Relabelling the Disk Relabel the disk using the label command. 


The disk label describes the sizes and boimdaries of the disk’s partitions. If you 
are satisfied with the default partitioning of the disk, you can continue with the 
next step of the installation in the following section: Copying the Miniroot. 


f - 

-\ 

format> label 


Ready to label disk, continue? y 


format> q 



J 


If any defects are found during surface analysis, they are automatically repaired 
if possible. If the automatic repair does not succeed, you need to repair them 
manually using the ’repair’ menu option in the format menu. See the System 
and Network Administration manud for more information. 

If you want to change the partitioning of the disk, use the partition menu option 
in the format main menu to create a table. After creating a partition table, 
make sure to run the label command afterwards to label the current disk. For 
more information on how to create a partition table, see the System and Network 
Administration manual. 

4.5. Copying the Miniroot 

How to Copy the Miniroot to This example shows how to copy the miniroot onto disk from a local tape drive. 

Disk 



If you are installing a SPARCsystem 300 or a Sun-3/80, your internal disk device 
is sd6. 


Example Variables The following variables are used in the following example: 

□ Local tape drive. 

□ stO is the tape device. See, SunOS Device Names in Chapter 2 of this 
manual for information on device name selections. 

□ sdO is the disk device. See, SunOS Device Names in Chapter 2 of this 
manual for information on device name selections. 
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Step 1: Halting the System 


Step 2: Booting the copy 
Program 


Halt your system using the following method: 

__________ . 

# /etc/halt 

_ : _ / 


Boot the standalone copy program from tape using the following method. 
-- 

>b f^(0,0r0} 

Boot:stO(0,0,0) 

Boot 0,2) 

Siz^:some_number+some_number+somejtumber bytes 
Standalone Copy 

_ > 



The ’2’ in (0,0,2) is the file on the tape that is being copied. 


Step 3: Copying the Miniroot Use the copy program to copy the miniroot from the distribution tape to your 

disk. 

Refer to the following table for the proper number sequence for the To: disk 
command line: 


Disk Device 

To: disk Command Line 

sdO 

sd(,0,l) 

sdl 

sd(,l,l) 

sd2 

sd(,8,l) 

sd3 

sd(,9,l) 

sd4 

sd(,10,l) 

sd6 

sd(,18,l) 


From:St0(0, 0,3) 
To (0,0,1) 



Revision A, of 25 April 1989 







60 InstaUing the SunOS 4.0.3 



The ’3’ in (0,0,3) is the file on the tape that is being copied. 

The ’ r in (0,0,1) is the partition on the disk where the file is being copied to. 


At the end of the copy, the copy program returns control to the bootstrap pro¬ 
gram: 


r 

Copy completed somejiumber bytes 

Boot: 



-J 


4.6. Booting the Miniroot 


Now that there is an operable miniroot on the disk, the bootstrap program can 
boot the miniroot, vmunix, from the disk. 



In the following example, sdO is the disk device being installed. 

If you are installing a SPARCsystem 300 or a Sun-3/80, your internal disk device 
is sd6. See, SunOS Device Names in Chapter 2 for a selection of possible device 
names. 


Boot Miniroot Example: The following example shows you how to boot vmunix using the boot process. 

Booting the miniroot Refer to the following table for the proper sequence that relates to your disk dev¬ 

ice: 


Disk Device 

Command Line Sequence 

SdO 

sd(,0,l) 

sdl 

sd(,l,l) 

sd2 

sd(,8,l) 

sd3 

sd(,9,l) 

sd4 

sd(,10,l) 

sd6 

sd(,18,l) 


r 

Boot :5:rf0(0. Or 1) vmunix 

-^ 

\_ 




You can specify the -a argument after vmunix if you want to specify the 
location of the root and swap partitions. Without the use of the -a argument, 
the Sun standard default is used. 
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Boot; s</0(0^0, l)vxnunix 

Size: somejiumber’¥some^number+somejuunber bytes 

SunOS Release 4.0,3 (MUNIX)#!; Thurs Mar 2 20:54:17 PST 1989 
Copyright(c) 1989 by Sun Microsystems, Inc. 

Tnem«4096k (0X400000) 

avail mem « 3186688 

Ethernet address « 8:0:20;0:7a:55 


disk and tape drive information 


ethernet controller information 

V_;_/ 



The ’r in (0,0,1) means booting from partition 1, which is actually the second 
partition or swap partition. 


Designating the root 
Filesystem 


When the miniroot is invoked, it displays some messages about the configuration 
of the system on which it is running, and displays the root filesystem location and 
type. 


root on rdOa fstype 4.2 



4.2 is a UNIX filesystem structure type. In SunOS 4.0, this is the only filesystem 
type available for the root filesystem. 


Designating the Swap Partition 


You will receive the following display that tells you the location of the swap 
filesystem and its type. 

< —---V 

swap on nsOa fstype spec size 1216k 
dump on nsOa fstype spec 

< ___. 



spec is a special type of partition used for the swap space. It does not have the 
structure of the partition used for the 4.2 filesystem and allows for more flexibil¬ 
ity. 
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explanation of suninstall. Read the next chapter carefully before you continue 
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How suninstall Works 


5.1. Introduction 


This chapter introduces the features of suninstall and provides an explanation of 
it’s menus and menu options. 


This chapter IS NOT meant to be used as a walkthrough example. For walk¬ 
through examples, see the next chapter. 

This chapter is meant only as an explanation of the suninstall program. It 
covers the following procedures and information: 

1. Understanding suninstall and its structure. 

2. How to start suninstall. 

3. How to enter your terminal type. 

4. How to enter the correct time zone. 

5. An explanation of the following suninstall menus. 

□ Main Menu 

□ Host Form 

□ Disk Form 

□ Software Form 

□ Qient Form 

5.2. What is suninstalH suninstall is the replacement for Setup, the Sxm Microsystems system installation 

tool for 3.x releases, suninstall is a tool that helps you install and maintain the 
4.x Operating System on Sun Workstations. The new suninstall features include 
the following: 

□ re-entrance 

You no longer need to re-enter all the information if you exit from the pro¬ 
gram. By restarting suninstall, the information saved before exiting from the 
program is displayed for your review and editing. 
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5.3. suninstall Structure 


□ Installation-interrupt 

If for any reason you need to stop the installation or change the information 
you entered, you can type ICTRL-CI to abort suninstall and then restart it. 
The information entered is retained. 

□ Mixed types of distribution tapes. 

suninstall allows you to install SunOS from any combination of distribution 
tapes. However, when installing a server, you cannot mix local and remote 
drives. For example, you can install a heterogeneous server with a set of 
\I2" Sun-2 tapes, a set of 1/4" Sun-3 tapes and a set of 1/2" Sun-4 tapes. This 
makes the installation procedure more flexible and convenient. 

□ Dataless configuration 

suninstall can build a standalone, server, or dataless configuration. See, Sec¬ 
tion 2.2 for definitions of these system configurations. 

□ Mixed architectures 


□ 


Now you can install as many architecture types as disk space allows. In 
SunOS 4.x, a heterogeneous server can support Sun-2, Sun-3, Sim-3x, Sun-4, 
and Sun-4c if there is enough disk space available for the executables of all 
these architectures. 

Standalone/server conversion 



You can now turn a 4.x standalone system into a 4.x server providing there 
is adequate disk space. You can also turn a server into a standalone without 
taking down or rebuilding the system. 


suninstall can be divided into two stages: 

1 . information gathering 

2 . installation 

suninstall displays five different information gathering forms. Each form 
requests data pertaining to a specific aspect of system configuration. 

When you start suninstall , it prompts you for the local time zone name and your 
system terminal type. The suninstall Main Menu is then displayed and you are in 
the information gathering stage of the installation. 



It is important that you edit the forms in the order in which they are listed in the 
main menu. Interdependencies exist between forms; information from the forms 
build on each other, suninstall will not allow you to fill out certain forms 
without a previous form being filled out. 
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When all of the infonnation needed by suninstall is entered, select [start the 
installation], from the main menu. This begins the automated portion of 
the installation. 


On-line Forms suninstall’s on-line forms are similar to questionnaires. Each form contains 

items that ask for a particular types of information. There are two types of infor¬ 
mation: 

□ Text 

Some menu items prompt you for information that requires you to type in 
the response. 

□ Choice 

Some menu items present a list of choices and ask you to select one element 
from the list. 

Each form consists of three regions: 

□ The top region consists of the title of the form and help guides for Text 
items. 

□ The middle region consists of the prompts. 

□ The bottom region consists of the message Are you finished with 
this form? [y/n]. 

Depending on the selection you choose, you either exit the form or revisit 
choice items on it. 

5.4. Starting suninstall To start suninstall, type suninstall on the command line. The suninstall 

program is invoked. Verily that you wish to continue with the installation, and 
you are prompted for your local time zone. 



There is no default for the time zone name. For a list of time zone name options, 
see Appendix B of this manual. 
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# suninstall 

Welcome to Suninstall 

You are about to install a new version of the SunOS on 
your system. If this is not a first-time installation 
and you are upgrading from a previous version of the 
operating system, then it is strongly recommended that 
you perform a full backup of each of your filesystems 
which contain user data. Be advised that as this program 
runs, it will re-label each of the disk drives and it will 
initialize a complete new set of filesystems. After this 
installation process is complete, you may restore your 
user data from backup copies. 

Do you wish to continue with the installation [y/n]? y 


Enter the local time zone name: 

» US/Pacific 


v_ j 



US/Pacific is the time zone name for Pacific Standard time in the United 
States of America. 

Once you have entered the correct time zone name, the screen displays the date 
and time. You are prompted to verify that the displayed date and time are 
correct. You can respond in one of the following ways: 

□ y- means that the displayed date and time is correct. 

□ n- means that is not correct. If the date and time is not correct, you must fill 
in the date and time based on the prompt format which is explained below. 


DatelTime Format The following two examples explain the date/time format. 

1 . dd/mm/yy 

dd stands for day of the month, mm stands for the month, yy stand for the 
year. 

2 . hh:mm:ss am/pm 

hh stands for hour, mm stands for minutes, s s stands for seconds, and 
am/pm stands for morning or afternoon. 

Once corrected, the system displays the corrected date and time. If this is 
satisfactory, type y. If not, type n and repeat the procedure. 
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The following is an example of entering the correct date and time: 

Enter the local time zone name: 

» US/Pacific 

la this the correct date and time [y/n]: 

» Fri Jul 1 21:30:11 PST 1968 

» n 

Enter the current date and local time. 

The date may be in one of the following formats: 
dd/mm/yy 
dd/mm/yyy 
dd.mm.yyy 
dd-mm-yyy 
dd-mm-yy^ 
month dd, yyy 
dd month yyy 

and the time may be in one of the following formats: 
hh am/pm 
hh: mm am/pm 
hh.mm 

hh:inm am/pm 
hh,mm 

hh:mm:ss am/pm 
hh:mm:ss 
hh^ram.ss am/pm 
hh.mm.ss 

» 03/09/88 12:20:30 

Is this the correct date/time [y/n]: 

Wed Mar 9 12:20:30 PST 1988 

» y 

^ _ > 


5.5. Entering Your 
Terminal Type 


After you have entered the correct time zone, or the correct date and time, you 
are prompted for your terminal type. A list of possible selections is displayed. If 
you select Other, you are prompted to type in your terminal type. 



The name of the terminal must correspond to a name in the TERMCAP database. 
To find a valid entry, do the following: 
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% cat /etc/terrocap 

regent 

ADDS Regent series 

vtlOO 

Digital Equipment VTIOO 

vt50 

Digital Equipment VT50 

vtl32 

Digital Ecjuipment VT132 

hlOOO 

Hazeltine 1000 

hlSOO 

Hazeltine 1500 

h2000 

Hazeltine 2000 

hl9~a 

Heathkit (Zenith) 19 

hp2€45 

Hewlett Packard 2645 

hp262l 

Hewlett Packard 2621 

hp2626 

Hewlett Packard 2626 

ibmSlOl 

IBM 3101 

adm3a 

Lear Siegler ADM 3A 

adm31 

Lear Siegler ADM 31 

adm3 

Lear Siegler ADM 3 

adin20 

Lear Siegler ADM 20 

adm42 

Lear Siegler ADM 42 

admS 

Lear Siegler ADM 5 

pe550 

Perkin Elmer Bantam 550 

tek4012 

Tektronix 4012 

tvi925 

Televideo 925 

tvi9l2 

Televideo 912 

tvi950 

Televideo 950 

wyse^-SO 

Wyse 50 

J 


The following example shows how to set the terminal type. 


Select your terminal type: 

1) Televideo 925 

2) Wyse Model 50 

3) Sun Workstation 

4) Other 

» 3 
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5.6. Using the Main Menu The Main Menu is displayed after you enter the correct time zone name, 

date/time, and terminal type. This marks the beginning of the information gath¬ 
ering stage of suninstall. Below is an illustration of the main menu followed by 
explanations of each of the menu items. 

Sun Microsystems System Installation Tool 
Main Menu 

On-line help information prints summary of cursor usage 
+ means the data file(s) exist(s) 

assign host information 

assign disk information 

assign software information 

assign client information 

on-line help information 

start the installation 

exit from suninstall 

[x/X=select choice] [space=next choice] [“B/*P=backward] [*F/“N=forward] 


MENU ITEMS DESCRIPTION 


assign host information 


assign disk information 


Gather system specific information. The Host Form is displayed if you select 
this choice. A"+" is displayed in front of this item if the data file(s) required by 
this form already exist. 

Gather partition sizes for attached disk device(s). The Disk Form is displayed if 
you select this choice. A "-i-" is displayed in front of this item if the data file(s) 
required by this form already exists. This occurs when you return to the form. If 
you exit the form without defining all attached disks, the is not displayed. 

Additional external disk devices may be switched off if you want to exclude 
them from suninstall. 


microsystems 
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assign software information 


assign client information 


List software categories to be extracted for the architecture type(s) specified. If 
you are installing a dataless configuration, you are not allowed to select any 
software since the system is sharing /usr with the server. Only required 
software categories are loaded in this case. A "+" is displayed in front of this 
item if the data file(s) required by this form already exist. 



Gather client information. The Qient form is displayed if you select this choice. 



If you are NOT installing a server, you do NOT edit this form. Type I Otrl-F I to 
skip this form. 


A"+" is displayed in front of this item if the data file(s) required by the form 
already exist. 


start the installation 


Start installation. 


on-line help information 


Produces the following help screen: 





ON-LINE HELP 




KEYS 

PURPOSE 


CONTROL F 

move cursor 

forward 

CONTROL N 

move cursor 

forward 

CONTROL B 

move cursor 

backward 

CONTROL P 

move cursor 

backward 

CONTROL U 

erase word 


<DELETE> 

erase one character 

CONTROL C 

abort 


<RETURN> 

end of input string 

X or X 

select a choice 

<SPACE> 

next choice 


Are you finished with this form 

[y/n] ? 




j 
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exit suninstall Leave the suninstall program. 

When you exit from suninstall, it saves a copy of everything you have completed 
up to that point. Later, if you re-invoke suninstall, you continue where you left 
off and do not have to re-enter information you input previously. 



If you reboot after you exit suninstall, all suninstall input is lost A copy of your 
input is only retained as long as you remain in the miniroot. 


5.7. Using the Host Form 


Below is an illustration of the Host form followed by explanations of the listed 
prompts. 


0 ^ 


This should be the first form you fiU out. The form below illustrates a dataless 
host. A * has been inserted in this illustration to show the prompts that are only 
displayed when a dataless configuration is selected. A ** has been inserted in 
this illustration to show the prompt that is only displayed when you have a yp 
type. 



The [upgrade] option on the Host Form is not supported in this release. To 
perform a system upgrade, you must use the SunOS 4.0.3 Upgrade tape. For 
more information, see the Performing a System Upgrade chapter in this manual. 
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HOST FORM [DEL=erase one char of input data] [RET=end of input data] 


Workstation Information : 

Name : 

Type : [standalone] [server] [dataless] 

* Server Name : 

* Server Internet Address : 

* Path of the executables on server: 

* Path of the sub-arch dependent execs on server: 

Network Information : 

Ethernet Interface 
Internet Address 
YP Type 

** Domain name 

Misc Information : 

Reboot after completed : [y] [n] 


Are you finished with this form [y/n] ? 

[x/X=select choice] [space=next choice] ["B/"P=backward] ["F/"N=forward] 

V___ 


[none] [interfaceO] [interfacel] 
192.9.200.1 

[none] [master] [slave] [client] 


MENU ITEMS 


DESCRIPTION 


Name 


Type 


Hostname of the system. Each machine on a network has a imique hosmame that 
is user defined. For more information on hostnames, see the Determining Net¬ 
work Information section in Chapter 3. 

See Chapter 2 in this manual for if you are not familiar with the differences 
between listed types. 


Server Name 


Name of the system that is serving /usr to this system. This prompt is 
displayed only when installing a DATALESS configuration. 


Server Internet Address Internet address of the system that is serving /usr to the dataless system. For 

information on Internet addresses, see the Determining Network Information sec¬ 
tion in Chapter 3. 


Path of the executables on 
server 


For DATALESS configurations, this is the path for the executables on the server. 


Path of the sub-arch dependent This path name is unique for a DATALESS configuration on the Host Form. It is 
executables on server the path for the sub-arch dependent executables on the server. For more informa¬ 

tion, see the Server Support of Sub-architectures section of Qiapter 2 in this 
manual. 
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Internet Address 


YPType 


Select [none] if you do not want the system to be on a networic. If you want the 
system to be on a networic, you should go through aU the Ethernet interfaces and 
assign the appropriate Internet addresses and name for each interface. For infor¬ 
mation on Ethernet addresses, see the Determining Network Information section 
in Chapter 3. 

This is the internet address of the first Ethernet interface. The displayed internet 
address is a default and should be replaced with your system internet address. 
Do not use the displayed default address. It can cause severe problems when 
you hook up to the Internet. For information on how to obtain an Internet 
address, see the Determining Network Information section in Chapter 3. 

YP master server, yp slave server, yp client or not using yp. 


Domain name 


YP domain name. For more information on domain names, see the Determining 
Network Information section in Chapter 3. 


Reboot after completed y reboots after installation is completed, n leaves in the miniroot environment 

after installation is completed. 





If you want to install a pre-configured kernel after suninstall is complete, select 
[ n ] in this field. For information on pre-configured kernels, see the Post¬ 
installation Procedures chapter of this manual. 


Are you finished with this form Entering y saves the input information and returns you to the Main Menu. Enter- 
[y/n] ? ing n returns you to the top of the form. 


5.8. Using the Disk Form Below is an illustration of the Disk form, followed by explanations of the listed 

prompts. 




During the installation, suninstall reports "ALL YOUR DISKS WILL BE RELA¬ 
BELED". This is misleading. ONLY the disks on which the filesystems are being 
installed will be relabeled. 

If you select [edit default] or [edit existing] from the Disk Form, 
suninstall will call format to rewrite the existing label. If the existing label 
contains partitions that are not in ascending order (a before b, etc), the partitions 
will be resorted and the existing data overwritten. To avoid losing aU previous 
information, back up all filesystems before beginning the installation. 

Also, if you select [ editexisting] for the Disk Label, you will have to input the 
path names for root, swap, home, etc. suninstall gives the sizes of each of these 
partitions, but not the path names. 


^sun 
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[Mbytes ] is the preferred selection in the Display Unit category in the 
Disk Form. 



If you are installing a heterogeneous server, you must select and label a 
/export/exec partition using this form. See the Remote Installation: Server 
in Chapter 6 of this manual for an example. 


-^ 

DISK FORM [DEL=erase one char of input data] [RET=end of input data] 


Attached Disk Devices : 

[diskO] [disk ] [disk ] 


Disk Label: [edit default] [edit existing] [use data file] 


Free Hog Disk Partition : 
Display Unit : 

PARTITION START__CYL BLOCKS 

[d] [e] 

[Mbytes] 

SIZE 

[f] [g] x[h] 

[Kbytes] [bytes] 

MOUNT PT 

[blocks] [cylinders] 

PRESERVE(Y/N) 

a 

0 

16048 

8 

/ 

n 

b 

59 

33456 

17 



c 

0 

276896 

141 



d 

0 

0 

0 



e 

0 

0 

0 



f 

0 

0 

0 



g 

570 

87856 

44 

/usr 

n 

h 

0 

0 

0 




Ok to use this partition table [y/n] ? 

Are you finished with this form [y/n] ? 

[x/X=select choice] [space=next choice] [ *B/“P=backward] ['■F/''N=forward] 

V_; 


MENU ITEMS 


DESCRIPTION 


Attached Disk Devices 


Attached disk devices are displayed in this area. 


Disk Label 


[edit default]= uses a default partition table. 

[edit existing]= uses the existing disk label. 

[use data file]= uses information saved from the previous edit of the disk form. 


^sun 
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Free Hog Disk Partition 


Display Unit 


Creating or changing disk labels should be done with caution. If the disk label 
needs to be changed after the operating system is installed, all of the information 
on the disk should be saved before modifying the label. Changing a hard 
partition’s size, or offset, effectively destroys aU of the information contained on 
that partition, and possibly other partitions as well. 

If changes are required, the first three partitions on the first disk must be labeled 
using the format program. This is necessary for the first disk (diskO) only. 
As the root and swap partitions reside on the first disk (diskO), the remaining 
disks (diskl,...) are available for other purposes and therefore not affected by this 
restriction. The sizes of partitions “a” and “b” can be changed in suninstall on 
aU disks other than diskO. 

Partition a: / root partition for the server 
Partition b: swap partition 
Partition c: the entire disk 

Partitions “d” through “h” can have their sizes changed using suninstall. 

The h partition is the default for the free hog partition, however, you can select 
another partition to hold unallocated disk space. The free hog partition is the 
partition disk space is taken from when another partition requires a size increase. 

suninstall will take space from the free hog partition if /usr is too small to 
accommodate the requested software selection. If /usr is larger than the 
requested amount of disk space, however, suninstall does not reduce its size. For 
more information on the free hog space, see the Planning Disk Space section in 
Chapter 3. 

AU numbers under the SIZE column are converted and displayed in die units 
specified. 


PARTITION This menu item is where you actuaUy partition your disk. 

Each partition has an offset and size, format expects partition offsets to be in 
cylinders, but size can be specified to suninstall in cylinders, blocks. Mbytes, or 
Kbytes, suninstall rounds to the nearest cylinder for purposes of formatting the 
disk. Overlapping hard partitions cannot be used by Unix simultaneously and so 
are not aUowed by suninstall. 

The configuration of the partitions are encoded within the disk label. The label is 
written to special locations on the disk by format (8) which is caUed by 
suninstall. The label is read from the disk by the SunOS at boot time to deter¬ 
mine the disk configuration. You can see the existing label by using the for¬ 
mat current command, or the command dkinfo(8). 






The “b” partition, typically the swap partition, can be increased but not 
decreased using suninstall. If you are installing a Sun-4 workstation, you wiU 
have to increase the “b” partition. 
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START_CYL 

BLOCKS 

SIZE 


MOUNT PT 


The starting cylinder for each partition, suninstall calculates this depending on 
the size value. 

The size of the partition in blocks. The system automatically fills in this infor¬ 
mation. 

The size of the partition in the units specified by the user. The user fills in the 
size of the partition in the units specified. When the number of blocks the parti¬ 
tion requires is specified, the system changes the BLOCK size automatically. 

File system mount point for the first disk. This applies only to the first disk. 

Partition a: should have / 

Partition b: has none 
Partition c: has none 


PRESERVE (Y/N) 


PRESERVE, specifies preserving the original filesystem. Type y if you want to 
preserve the original filesystem on the disk partition. 



Type n if you made changes to disk partition sizes and want to use these 
changes. This creates a new filesystem. 


If you alter the starting point of a cylinder block, you cannot preserve the original ^' 3 

disk state because you wrote over die starting point of another cylinder. When 
you create a new file system, you destroy all existing data in the partition. In 
some cases, you cannot preserve the free hog partition. 


OK to use this partition table The data wiU be saved and used to label the disk when the installation is started, 
[y/n] ? 


Are you finished with this form 
[y/n] ? 


Type y to exit from this form. 

Type n to specify labels for additional disks on the system. The cursor returns to 
the top of the form to specify the next disk. 


5.9. Using the Software 
Form 


The Software form is illustrated below with explanations of the listed prompts. 
This form is required for all system configurations. 



When performing a full installation, if you select own choice on the Software 
Form, suninstall automatically selects aU required software categories and then 
allows you to select any optional software. If you add software after the installa¬ 
tion is completed using the setup_exec utility, you are allowed to add only 
selected optional software. 
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If you press ICTRL-CI when the tape is reading or rewinding, your system will 
core dump. 

If you have not allocated enough space for the choices you make in the software 
form, suninstall automatically goes to the free hog partition and takes what is 
required to load the selected software choices. This decreases the free hog parti¬ 
tion, and increases the partition you have chosen for the software. You will 
notice that there are considerable pauses between categories. 

The following table lists the available software categories for you to choose from 
on the Software Form, the category type, and a description of each category. The 
following terms are used to describe the software category Type: 

required 

A software category that is necessary for you to bring up your system, 
desirable 

A software category that is recommended for optimal system use, but not 
essential to bringing up the system. 

optional 

A software category selection at the discretion of the user, 
common 

An optional software category that is generally selected. 

See the Read This First Document for the release for exact sizes of each of the 
following software categories. 
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Software Category 
Interdependencies 


Table 5-1 Software Categories 


Category 

Type 

Description 

root 

required 

root filesystem 

usr 

required 

user files 

kvm 

required 

kernel dependent files 

Sys 

desirable 

system files 

Netwoiking 

desirable 

netwoiking files 

Debugging 

optional 

debugging programs 

SunView_Users 

common 

suntools 

SimView_Programmers 

optional 

libraries to write 
window system interface 

SimView_Demo 

optional 

demo programs 

Text 

optional 

text formatting 

Install 

required 

suninstall 

User_Diag 

optional 

self-test programs 

Graphics 

optional 

graphics package 

UUCP 

optional 

modem communications 

System_V 

optional 

System V UNIX 

Manual 

optional 

manual pages 

Demo 

optional 

demonstration programs 

Games 

optional 

user games 

Versatec 

optional 

Versatec interface 

Security 

optional 

C2 security features 


Be aware of the following interdependencies between software categories when 
selecting software on the Software Form. 

□ If you select Manual for the man pages, you must also select Text. Without 
selecting Text, the man pages will not format for display. 

□ You must select Networking if you are installing a server. 

□ If you select SunViewJDemo, you must also select 
SunView_Programmers, SunView_Users, and Graphics software 
categories. 




A * is inserted in the following form to show menu options that are only 
displayed when remote is selected. 
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SOFTWARE FORM [DEL=erase one char of input data] [RET=end of input data] 
Architecture Information : 

Type : [sun2] [sun3] [sun3x] [sun4] [sun4c] 

Path where executables reside : 

Path where sub-arch dependent executables reside: 


Media Information: 

Device Type : [stO] [stl] 
Drive Type : [local] [remo 

* Tapehost : 

* Tapehost's Internet Address : 


[stO] [stl] [st2] [arO] [mtO] [xtO] 
[local] [remote] 


Choice 


[all] [default] [own choice] [required] [quit] 


CATEGORY 


BYTES 


AVAIL BYTES 


required 

required 

required 

desirable 

desirable 


Sys 

Networking 


181248 

20971520 

2620416 

2720768 

953344 


8216576 

4498227217 

24010752 

21289984 

20336640 


Are you finished with this form [y/n] ? 

[x/X=select choice] [space=next choice] [ "B/"P=backward] [ "F/'‘N=forward] 


MENU ITEMS 


DESCRIPTION 


Architecture type of the executables. 


Path where executables reside 


The directory location of executable files, /export/exec/c//enr_A/?C// is 
the the default assumption for the path name. 


Path where sub-arch dependent 
executables reside 


The directory location of the executable files which vary according to the sub¬ 
architecture. /export/exec/kvm/c//eAir_A/?C// is the default assumption for 
the path name. For more information, see the Server Support of Sub- 
architectures section of Chapter 2 in this manual. 


Device Type 


The media device type. 


Drive Type 


Local or remote tape drive. 


Tapehost 


In the case of a remote installation, the system with the tape drive. 
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Tapehost’s Internet Address 
Choice 


In the case of a remote installation, the internet address of the tapehost. 



[all] loads all of the software categories from the distribution tape(s). 

[default] loads aU of the common software categories from the distribution 
tape(s). 

[own choice] loads all of the required software categories from the distribu¬ 
tion tape(s), and prompts you for the optional software categories. 

[required] loads only the required software categories from the distribution 
tape(s). 

[quit] exits the form. 



If you are installing a heterogeneous server, you are prompted to select the archi¬ 
tectures from the Architecture Information Type field. You must go 
through separate Software Form for each architecture type you are installing and 
answer the questions to suit its requirements. 


CATEGORY, NAME, BYTES, 
AVAILABLE BYTES, Y/N 


Each software category is displayed in this area. All required categories have y 
under Y/N and required under CATEGORY. If the category is optional, 
optional is displayed under CATEGORY. If the category is desirable, 
desirable is displayed under CATEGORY. You have to answer yor n 
under Y/N for these optional categories. When you select a category, its size is 
automatically displayed under BYTES. AVAILABLE BYTES also displays the 
amount of free space that remains. If you run out of available space, suninstall 
automatically increases the size of the partition by taking space from the free hog 
partition, "from free hog" is displayed under the field avail bytes. 



When you have selected all the optional software, suninstall lists the items you 
selected and prompts you to verify their correcmess. 


Are you finished with this form? Entering y returns you to the main menu. Entering n leaves you in the current 
y/n form. 


5.10. Using the Client 
Form 


Below is an illustration of the Qient form followed by explanations of the menu 
items. This form is only required when installing a machine as a server for a 
diskless client. 



The Qient Form does not automatically fill out the default for the client /home 
path and swap size. You must fill in this information yourself. 



®sun 

Xr microsystems 


Revision A, of 25 April 1989 



Chapter 5 — How suninstall Works 83 


- 

CLIENT FORM [DEL=erase one char of input data] [RET=end of input data] 


Architecture Type : [sun2] [sun3] [sun3x] [sun4] [sun4c] 

Choice : [create] [delete] [display] [next arch] 

Client(s) : 


Client Information : 

Name : 

Internet Address : 

Ethernet Address : 

YP Type : [none] [master] [slave] [client] 

Domain name : 

Path of Client's Root : 

Path of Client's Swap : 

Path of Client's Executables : 

Path of Client's Sub-Arch Dependent Executables : 

Path of Client's Home : 

Swap size (e.g. 8M,8m^8K,8k,8B or 8b) : 

Are you finished with this form [y/n] ? 

[x/X=select choice] [space=next choice] ["B/"P=backward] ["F/"N=forward] 

V-————___> 


MENU ITEMS DESCRIPTION 


Architecture Type Architecture type of the client 

Choice [create] displays default client data and allows you to assign the client host- 

name. 

[display] displays information for the specified client or an error message if 
the client does not exist. You specify the client by typing the client name in the 
Client: field. 

[delete] deletes the specified client or displays an error message if the client 
does not exist. You specify the client by typing the client name in the Client: 
field. 

Client(s) Client(s) of specified architecture type are displayed in this area as they are 

entered. 

Name Client hostname. 
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Internet Address 


Client IP address. 


Ethernet Address 
YPType 

Domain Name 


Client Ethernet address. 

YP master server, YP slave server, YP client or not using YP. A diskless client 
usually is not a YP server. 

YP domain name. 


Path of Client’s Root If specified, /path/clientname is the root directory of the specified client. 

Automatically appends the client hostname to the path of the client’s root The 
default is: /export/root/clientname. 

Path of Qient’s Swap If specified, /path/clientname is the swap file of the specified client. The 

default is: / export/swap/clientname. 


Path of Qient’s Executables 


Path of Qient’s Sub-arch 
Dependent Executables 


Path of Qient’s Home 


Swap Size 


If specified, /path on the server is mounted on /usr on the client. The 
default is: /export/exec/client_A/?C//. These are the client’s 
architecture-dependent executables. 

If specified, /path is the directory where the client’s sub-architecture 
dependent executable files reside. The default is: 

/export/exec/kvm/c/renr_ARC//. For more information, see the Server 
Support of Subarchitectures section of Qiapter 2 in this manual. 

If specified, /path is the directory where the client’s home directories reside. 
The default is: /home. 

Swap reserved for the specified client. These sizes are specified in megabytes, 
kilobytes, or blocks. The default is 16 megabytes, (e.g. 16M, 16m, 16000K, 
16000k,or 16000000b) 


Are you finished with this form? y allows you to exit from the form, n returns you back to the top of the form to 
[y/n] add, modify, or delete clients. 

5.11. The Installation 

How Long Will it Take? Time estimates for an installation vary according to the equipment used. It is 

also affected by the number of clients and the number of disks involved. 

The 1/4 inch tape now has a no-rewind capability xmder suninstall which cuts 
installation times drastically. The type of Sim workstation you are installing on 
also makes a difference. The Sun-4 is the highest performance workstation and 
therefore is the quickest to install. The Sun-3 is the next fastest, followed by the 
Sun-2. 

While it is difficult to give an exact time estimate for an installation, there are 
rule-of-thumb estimates that are listed below: 
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These are estimates for installing a system using only the selected software. 


Table 5-2 Installation Time Estimates 


Workstation 

Tape 

SunOS Release 

Selected Software 

Time Estimate 

Sun-2 

1/4" 

4.0 

text, install, 
SystemV 

1.5 hours 

Sim-3 

1/2" 

4.0 

text, install, 
SystemV, Man 

2 hours 

Sun-4 

1/4" SCSI 

4.0.3 

All 

1/2 hour 

Sim-4 

1/2" SCSI 

4.0.3 

All 

1/2 hour 


When you select [ start the installation ] from the main menu in 
suninstall, the installation begins. You will be prompted when the tape needs to 
be changed. 



You can abort the installation any time by using I Ctrl-C I except during the crea¬ 
tion of the filesystem. If you abort the installation within the first five minutes 
after selecting [ start the installation ] , the miniroot is des¬ 
troyed. 


Before you restart suninstall, you should make sure no disk partitions are 
mounted. You can re-assign information by starting suninstall. The information 
you entered the first time is displayed. You have the option of changing any por¬ 
tion of the information without re-entering it over again, or you can change aU 
the information. You do not have to abort the system, reload miniroot, and re¬ 
enter all previous information if you need to stop the installation. 

When you start the installation fi’om the [ start the installation ] 
option in the main menu, the system is built using the information entered from 
the suninstall menu forms. If you select the reboot option in the Host Form, the 
system is rebooted after the installation is complete. The system is then in mul¬ 
tiuser mode with the following prompt on the screen when ready for use. 


hostname login: 


If you do not select the reboot option in the Host Form, the system remains in the 
miniroot after installation is completed and the following messages are displayed 
on the screen. 


microsystems 
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System Installation Con^lete. 

If you do not wish to install a smaller 
generic kernel, you may reboot the system 
now and configure a kernel for your system. 
# 


You can then bring up the system to multiuser mode by aborting and then boot¬ 
ing the system. Refer to CAap/er 5 for the abort sequence. Boot the system by 
typing the following: 



If the system is either a YP master server or YP slave server, you need to set up 
the YP database after the system comes up in multiuser mode. Details for insti¬ 
ling and maintaining YP databases are in the System and Network Administration 
manual. 


5.12. Installing a root 
password 


After you bring up your new system for the very first time, you may want to add 
a root password. 


D 



REMEMBER! ! ! ! ONCE A PASSWORD IS GIVEN TO ROOT, YOU 
CAN NOT LOGIN AS ROOT AGAIN WITHOUT GIVING THE CORRECT 
PASSWORD. 

If you forget the password, boot single user and redefine the root password. See 
the System and Network Administration manual for more information. 


To add a root password do the following: 


- 

login: root 
# passwd 

[The system will prompt you for your new password ] 

New Password: (password not displayed) 

[The system will prompt you to verify the new password] 
Verify Password: (password not displayed) 

V_ 


If you are upgrading or reinstalling an existing system, there is probably an exist¬ 
ing root password in the /etc/passwd file. This file will be restored as 
part of the upgrade reinstallation. Again, if there isn’t one, just do the above 
after you reboot the system. 




Revision A, of 25 April 1989 










Walkthrough Examples 


Walkthrough Examples. 89 

6.1. Introduction. 89 

Local Installation Examples. 89 

Remote Installation Examples. 89 

Preparatory Local Installation Steps. 89 

System Assumptions for the Walkthrough Examples. 89 

_ 6.2. On-Line Help. 90 

6.3. Preparatory Local Installation Steps. 91 

Stq? 1: Becoming Super User . 91 

Step 2: Making Full Dumps . 91 

Step 3: Halting the System . 91 

Step 4: Labeling the Disk . 91 

Step 5: Copying the miniroot . 92 

6.4. Local Installation: Standalone. 94 

Example Variables:. 94 

Installation Steps: . 94 

Step 1: Completing Preparatory Local Installation Steps . 94 

Step 2: Starting suninstall . 94 

Step 3: Assigning Host Information . 96 

Step 4: Assigning Disk Information . 98 

Step 5: Assigning Software Information . 99 

Step 6: Adjusting the /usr Partition . 101 

Step 7: Starting the Installation . 101 





























Step 8: Review /suninstall.log File . 102 

Step 9: Aborting the System . 102 

Step 10: Booting the System . 102 

Step 11: Completing Post-installation Procedures . 102 

6.5. Local Installation: Homogeneous Server. 103 

Example Variables:. 103 

Installation Steps: . 103 

Step 1: Completing Preparatory Local Installation Steps . 103 

Step 2: Starting suninstall . 103 

Step 3: Assigning Host Information . 105 

Step 4: Assigning Disk Information . 106 

Step 5: Assigning Software Information . 108 

Step 6: Assigning Client Information . 110 

Step 7: Adjusting the /usr Partition . Ill 

Step 8: Starting the Installation . Ill 

Step 9: Review /suninstall.log File . 112 

Step 10: Aborting the System . 112 

Step 11: Booting the System . 112 

Step 12: Running ypinit . 112 

Step 13: Completing Post-installation Procedures . 113 

6.6. Local Installation: Dataless. 114 

Example Variables:. 114 

Installation Steps:. 114 

Step 1: Completing Preparatory Local Installation Steps . 114 

Step 2: Starting suninstall . 114 

Step 3: Assigning Host Information . 116 

Step 4: Assigning Disk Information . 118 

Step 5: Assigning Software Information . 119 

Step 6: Adjusting the /usr Partition . 121 

Step 7; Starting the Installation . 121 

Step 8: Review /suninstall.log File . 122 

Step 9: Aborting the System . 122 

Step 10: Booting the System . 122 

Step 11: Completing Post-installation Procedures . 122 

6.7. Remote Installation: Standalone. 123 









































Introduction. 123 

Example Variables:. 124 

I. EXECUTING format AND BOOTING THE 

MINIRQQJ.. 125 

Step 1: Copying the Miniroot from Tape . 125 

Step 2: Setting!etc!hosts and Ietclethers . 125 

Step 3: Executing setup_client . 125 

Step 4: Booting from the Remotehost . 126 

Step 5: Creating the Disk Devices . 127 

Step 6: Changing Disk Partition Sizes . 127 

Step 7: Copying the Miniroot to Disk . 127 

Step 8: Booting the Miniroot . 128 

II. EXECUTING 128 

Step 1: Editing l.rhosts . 128 

Step 2: Starting suninstall . 128 

Step 3: Assigning Host Information . 130 

Step 4: Assigning Disk Information . 131 

Step 5: Assigning Software Information . 132 

Step 6: Adjusting the Iusr Partition . 134 

Step 7: Starting the Installation . 134 

Step 8: Reviewing suninstall.log . 135 

Step 9: Removing the Client Partition . 136 

Step 10: Completing Post-installation Procedures . 136 

























Walkthrough Examples 


6.1. Introduction This chapter provides walkthrough examples for installing with a local tape drive 

and a remote installation. 

Local Installation Examples The walkthrough examples for a local installation provide a separate example for 

each of the following system configurations: 

□ Standalone Configuration 

□ Homogeneous Server Configuration 

□ Dataless Configuration 

Remote Installation Examples There is one remote installation walkthrough example to show the basic differ¬ 
ences from the local installation. The remote installation example illustrates the 
following system configuration: 

□ Standalone Configuration 

Preparatory Local Installation The first steps of each local installation configuration are the same. In an attempt 
Steps to decrease the bulk of the walkthrough examples, these steps are consolidated 

into the Preparatory Local Installation Steps section preceding the walkthrough 
examples, instead of repeating them in each example. Complete these steps 
before beginning the local installation walkthrough of your choice. 


System Assumptions for the Each walkthrough example is based on a list of system assumptions. The 
Walkthrough Examples assumptions detae the equipment and network information for the installation. 

The assumptions are listed at the beginning of the example. 



You do not have to configure your system exactly as shown. These are simply 
examples to help you design your own system configurations. Read the example 
of your choice completely BEFORE you begin to install or modify your system. 
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6.2. On-Line Help If you need help at any time during the installation, you can call up the On-Line 

Help screen for suninstall specific information by using the following steps: 

1. Go the bottom of the form, answer yto Are you finished with 
this form [y/n] ?. This brings you back to the Main Menu. 


2. Select on-line help information. The following screen is 
displayed: 


ON-LINE 

HELP 

N 





KEYS 

PURPOSE 


CONTROL F 

move cursor forward 


CONTROL N 

move cursor forward 


CONTROL B 

move cursor backward 


CONTROL P 

move cursor backward 


CONTROL U 

erase word 


<DELETE> 

erase one character 


CONTROL C 

abort 


<RETURN> 

end of input string 


X or X 

select a choice 


<SPACE> 

next choice 

Are you 

finished with this form 

[y/n] ? 





3. When you are finished, exit and return to the form you were in prior to enter¬ 
ing the help screen. 
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6.3. Preparatory Local 
Installation Steps 


The following steps are required before starting suninstall. Complete these steps 
before beginning the local installation walkthrough of your choice. 


Step 1: Becoming Super User 
Step 2: Making Full Dumps 

Step 3: Halting the System 


Become super user by typing su and then your super user password. 

Make full dumps of all filesystems. For information on how to do this, see the 
System and Network Administration manual. 

Halt the system in the following way; 


boomer#/etc/halt 


Step 4: Labeling the Disk If you are installing this release on a new disk that does not have a label yet; or if 

you wish to change the size of the root partition or the swap partition, copy 
MUNIX and run format to label your disk as shown in the following example. 

For more information, see Chapter 4. If you do not wish to change the existing 
disk label, go to the next step. 
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>l> tap0{\ 
hoot.itape{Ot 0,4) 

Stzei some number + some number bytes 

SunOS Release 4-0.3 (MUNIX)#1; Thurs Mar 2 20:54:17 PST 1989 

Copyright(c) 1989 Sun Microsystems, Inc- 

mem - 4096K <0X400000) 

avail mem 3186688 

Ethernet address “ 8:0:20:07a:55 


disk and tape drive information 


ethernet controller information 


init ram disk from device (st%d{a“h] sd%d[a-hl ft%d[a-h]): tapeO 

rd: reading 176, 8192 byte blocks.... 

root on rdOa fstype 4.2 
tape file number?5 

swap on nsOa fstype spec size 1216K 
dump on nsOa fstype spec 

# format 

L.U-aJ 

(or proper abort sequence to exit format) 

V_> 


Step 5: Copying the miniroot Copy the miniroot using the following method. In the To: disk command 

line below, replace the # sign with the appropriate number for your disk device. 
Refer to the following table for the proper command line sequence. 


Disk Device 

To: disk Command Line 

sdO 

sd(,0,l) 

sdl 

sd(,l,l) 

sd2 

sd(,8,l) 

sd3 

sd(,9,l) 

sd4 

sd(,10,l) 

sd6 

sd(,18,l) 


For more in-depth information, see the Copying the Miniroot section in Chapter 
4 of this manual. 
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6.4. Local Installation: 
Standalone 


Example Variables: 


The following variables are used in this walkthroug example. If you are using 
this example as a guide to install your own system, use the device names and net- 
woik information applicable to your system. 


o hostname: trigger 

□ architecture: sun3 

□ ethemet interface: ieO 

o system type: standalone 

□ internet address: 192.9.90.64 

□ local SCSI tape drive: stO 

□ 1 Xylogics 451 controller with Eagle disk: xyO 

□ yp client of domain: home.on.the.range 

□ software categories: all 



Installation Steps: 

Step 1: Completing Preparatory Complete the preparatory local installation steps at the beginning of this chapter. 
Local Installation Steps 


Step 2: Starting suninstall Start suninstall and enter the proper time zone name and terminal type. 





sun 
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# suninstaXX 

Welcome to Suninatall 

Yon are about to install a new version of the SunOS on your system. 

If this is not a first-time installation and you are upgrading from 
a previous version of the operating system, then it is strongly recom¬ 
mended that you perform a full backup of each of your filesystems 
which contain user data. Be advised that as this program runs, it may 
re-label some of the disk drives and in some cases initialize new 
filesystems. After this installation process is complete, you may 
restore your user data from backup copies. 

Do you wish to continue with the installation [y/nj? y 


Enter the local time zone name: 

» US/Pacific 

Is this the correct date/time [y/n]: 

Mon Mar 14 08:06:57 PST 1988 

Select your teinninal type: 

1) Televideo 925 

2) Wyse Model 50 

3) Sun Workstation 

4) Other 


The suninstall Main Menu is displayed. 



sun 

ffliefSBysfems 
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r —””” > 

Sun Microsystems System Installation Tool 

Main Menu 

On-line help information prints summary of cursor usage 
+ means the data file(s) exist(s) 

assign host information 

assign disk information 

assign software information 

assign client information 

on-line help information 

start the installation 

exit from suninstall 

[x/X=select choice] [space=next choice] [ "B/''P=backward] ["F/"N=forward] 

\ _ ) 


Step 3: Assigning Host To assign host information, select assign host information from the 

Information suninstall Main Menu. The following Host Form is displayed. 

Enter the hostname of the machine and put an X next to standalone. 



If you are going to install a pre-configured kernel after suninstall has completed, 
answer n to the question: Reboot after completed. For more informa¬ 
tion on pre-configured kernels, see the Post-installation Procedures chapter of 
this manual. 
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HOST FORM 


[DEL-erase one char of input data] [RET-end of input data] 


Workstation Information : 

Name [Internet Name 0] : trigger 

Type : x[standalone] [server] [dateless] 


Network Information : 

Ethernet Interface : [none] x[ie0] 
Internet Address 0 : 192SS0.64 

Internet Name 0: trigger 


YP Type 
Doma inname 


: [none] [master] [slave] x[client] 

: home.onJhe.range 


Misc Information : 

Reboot after completed : x[y] [n] 


Are yOn finished with this form [y/n] ? y 

[x/X-select choice] [space-next choice] ["B/^P-backward] ["F/^N-forward] 


The main menu is displayed when you answer y to the last prompt: Are you 
finished with this form [y/n]?. 



Revision A, of 25 April 1989 





98 Local Installation: Standalone 


Step 4: Assigning Disk To assign disk information, select assign disk information from the 

Information suninstall Main Menu. 

The displayed Disk Form is different depending on the type of system selected 
on the Host Form. The following Disk Form is displayed for a standalone 
configuratioa 


DISK FORM 


{DEL=erase one char of input data] CRET=end of input data] 


Attached Disk Devices : 
X[ xyO] 


Disk Label : xtedit default] 

Free Hog Disk Partition : Id] [e] 
Display Unit : x[Mbytes] 


[edit existing] [use data file] 

[f] tg] x[h] 

[Kbytes] [bytes] [blocks] [cylinders] 


PARTITION START CYL BLOCKS 


a 

b 

c 

d 

e 

f 

9 

h 


0 

59 

0 

0 

0 

0 

570 

893 


16048 

33456 

276896 

0 

0 

0 

87856 

34000 


SIZE 

S 

17 

141 

0 

0 

0 

44 

17 


MOUNT PT 


PRESERVE(Y/N) 


/usr 

/hone 


n 

n 


ok to use this partition table ly/n] ? y 
Are you finished with this form [y/n] ? y 
[x/X=select choice] [space=next choice] 


[-B/'‘P=backward] ["F/''N=forward] 


The numbers under the columns START_CYL, BLOCKS, and SIZE are for this 
example only. The numbers are different for each disk and depend on the exist¬ 
ing label on the specified disk and what you select for partitions d-h. 



PRESERVE (Y/N) 

PRESERVE, specifies preserving the original disk state. If you answer Y to 
this, you preserve the original filesystem. If you answer N to this you create 
a new filesystem and the data from the original filesystem is destroyed. 

If you alter the starting point or size of a partition, you cannot preserve its 
original state, or any other partition’s state that is forced to be relocated as a 
result of re-partitioning. 


The main menu is displayed when you are finished with the form. 
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Step 5: Assigning Software 

Information To assign software information, select assign software information 

from the suninstall Main Menu. The Software Form is displayed on the screen. 


. . — ^ ^ ^ ^ > 

SOFTWARE FORM [DEL^erase one char of input data] [RET^^end of input data] 


Architecture Information : 

Type :[sun2] x[sun3] [sun3x] [sun4] tsun4c] 

Rath where executables reside :/usr 

Rath where sub--arch dependent executables reside: /usr/kvm 
Media Information: 

Device Type : xtstO] tstl] [st2] [arO] [mtO] [xtO] 

Drive Type : x{local] [remote] 


Choice : x[all] [default] [own choice] [required] [quit] 


CATEGORY 

NAME 

BYTES 

AVAIL BYTES 

y/N 

required 

root 

181248 

8216576 

y 

required 

usr 

20971520 

44982272 

Y 

required 

Kvm 

2620416 

24010752 

y 

required 

Install 

1153024 

9558037 

y 

desirable 

Sys 

2720768 

21289984 

y 

desirable 

Networking 

953344 

20336640 

Y 


Are you finished with this form [y/n] ? 

[x/X-select choice] [space^^next choice] ("B/"P=backward] t'^F/''N=forward] 
k---^ 


The list of categories to be extracted for the Sun-3 architecture are displayed on 
the Software Form after you make your selection. 
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SOFTWARE FORM {DEL-erase one char of input data! [RET-end of input data) 


Architecture Information : 

Type :[sun2] xlsunS] [sun3x] [sun4] [sun4c] 

Path where executables reside :/usr 

Media Information: 

Device Type ; at[stOJ [Stl] [st2) [arO] [mtO] [xtO] 
Drive Type : x[local] [remote] 


Choice : x[all] [default] [own choice] [required] [quit] 


Extract list: 

root 

usr 

Kvm 

Install 

Sys 

Networking 

Debugging 


OK to u$e the extract list [y/n] ? y 
Are you finished with this form ty/n] ? y 

{x/X=select choice] [space=next choice] ["B/"P=backward] ["F/"N=forward] 


The surdnstall Main Menu is displayed when you exit this form. 
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''W' Step 6: Adjusting the lusr 
Partition 


After you select the software, return to the Disk Form. Add approximately 5-10 
Mb to the /usr partition to allow for customizing the kernel. 


Step 7: Starting the Installation To start the installation, select start the installation from the si/nm- 

stall Main Menu. 


You are prompted when the tape needs to be changed. If any information is 
missing, the installation will not start. You can go back and assign missing 
information and start again. 


The following messages are displayed after the installation begins: 


-- 

System Installation begin : 

Label disk(s) : 
xyO 

Create/Check Filesystems: 

/dev/rxyOa: 140624 sectors in 752 cylinders of 11 tracks^ 17 sectors 

72.0Mb in 47 cyl groups (16 c/q, 1.53Mb/g, 640 i/g) 
super-block backups (for fsck -b#) at: 



32, 3056, 6080, 9104, 

12128, 

15152, 

18176, 

21200, 

24224, 

27248, 


w 

30272, 

33296, 36320, 

39344, 

42368, 

45392, 

47904, 

50928, 

53952, 

56976, 

60000, 

63024, 66048, 

69072, 

72096, 

75120, 

78144, 

81168, 

84192, 

87216, 


Sun3 Installation Begin: 

Creating ”root” filesystem 

Extracting **usr” files from ”/dev/nrst0” release tape 
Extracting ”kvm” files from ”/dev/nrst0” release tape 
Extracting "install files from ”/dev/nrst0” release tape 


Sun3 installation completed. 
System installation continues.. 

File systems check: 


If you do not wish to install a small pre-configured 
kernel^ you may reboot the system now and 
configure a kernel for your system. 
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If you install a SPARCsystem 300 or a Sun-3/80, see the Post-installation Pro¬ 
cedures chapter of this manual for information on how to boot the internal disk 
and modify the boot prom. 


Step 8: Review lsuninstall.log Review the /usr/etc/install/f iles/suninstall. log file. Errors 
File from utilities, such as tar, will appear in this file even if they scroll off the 

screen during installation. 


Step 9: Aborting the System Abort the system using I Ll-A 1 for Sun monitors or I BREAK 1 for tty terminals. 

See the Abort Sequence section of Chapter 3 of this manual for more informa¬ 
tion. 


Step 10: Booting the System 


Step 11: Completing Post¬ 
installation Procedures 


You selected automatic reboot once the installation was complete. If for 
some reason the system does not reboot automatically, boot the system in the fol¬ 
lowing way: 



Complete post-installation procedures as necessary. See Chapter 7 of this 
manual for a list of post-installation procedures. 

If you want to set a root password, see Chapter 5 of this manual. 
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6.5. Local Installation: 

Homogeneous 

Server 

Example Variables: The following variables are used in this walkthrough example. If you are using 

this example as a guide to install your own system, use the device names and net¬ 
work information applicable to your system. 

□ hostname: trigger 

□ architecture: sun3 

□ ethemet interface: ieO 

□ system type: server 

□ internet address: 192.9.90.64 

□ client: tonto 

□ client architecture: sun3 

□ client internet address: 192.9.1.1 

o local SCSI tape drive: stO 

□ 1 Xylogics eagle disk: xyO 

□ yp client of domain: home.on.the.range 

□ software categories: all 

Installation Steps: 

Step 1: Completing Preparatory Complete the preparatory local installation steps at the begirming of this section. 

Local Installation Steps 

Step 2: Starting sminstall Start suninstall and enter the proper time zone name and terminal type. 
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# suninstaXl 

Welcome to Suninstall 

You are about to install a new version of the SunOS on your system. 

If this is not a first-time installation and you are upgrading from 
a previous version of the operating syste, then it is strongly recom¬ 
mended that you perform a full backup of each of your filesystems 
which contain user data. Be advised that as this program runS/ it may 
re-label some of the disk drives and in some cases may initialize new 
filesystems. After this installation process is complete, you may 
restore your user data from backup copies. 

Do you wish to continue with the installation [y/n]? y 

Enter the local time zone name: 

» VSIPacific 

Is this the correct date/time [y/n]: 

Mon Mar 14 08:08:57 PST 1988 

» y 

Select your tenuinal type: 

1) Televideo 925 

2) Wyse Model 50 

3) Sun Workstation 

4) Other 


» 3 





The suninstall Main Menu is displayed. 
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Sun Microsystems System Installation Tool 

Main Menu 

On-line help information prints summary of cursor usage 
+ means the data file(s) exist(s) 

assign host information 

assign disk information 

assign software information 

assign client information 

on-line help information 

start the installation 

exit from suninstall 

[x/X=select choice] [space=next choice] ["B/"P^backward] ['"F/"N=forward] 

V- ^ 


Step 3: Assigning Host 
Information 


To assign host information, select assign host information from the 
suninstall Main Menu. The Host Form is displayed. 

Enter the hostname of the machine and put an X next to server. 



If you are going to install a pre-configured kernel after suninstall has completed, 
answer n to the question: Reboot after completed. For more informa¬ 
tion on pre-configured kernels, see the Post-installation Procedures chapter of 
this manual. 
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HOST FORM [DEL^erase one char of input data] [RET=end of input data] 


Workstation Information : 

Name [Internet Name 0] : trigger 

Type : [standalone] x[server] [dataless] 


Network Information : 

Ethernet Interface : [none] x[ie0] 
Internet Address 0 : 192.9.90.64 

Internet Name 0: trigger 


YP Type 
Domainname 


; [none] [master] [slave] x[client] 

: home.on.thej’ange 


Misc Information ; 

Reboot after completed : x[y] [n] 


Are you finished with this form [y/n] ? y 

Ix/X=select choice] [space=next choice] [''B/''P=backward] [ ^F/'‘N=forward] 


Step 4: Assigning Disk 
Information 


The main menu is displayed when you answer y to the last prompt: Are you 
finished with this form [y/n]?. 

To assign disk information, select assign disk inf ormation from the 
suninstall Main Menu. 

The displayed Disk Form is different depending on the type of system selected 
on the Host Form. The following Disk Form is displayed for a server 
configuration. 



sun 
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DISK FORM 

tDEL=erase 

one char of 

input data] [RET= 

-end 

of input data] 


Attached Disk 

Devices : 






x[ xyO] 







Disk Label 


xledit default] [edit existing] 

[use data file] 


Free. Hog Disk 

Partition : 

[d] tel [f] [g] xih] 




Display Unit 


X [Mbytes] 

[Kbytes] [bytes] 

[blocks] [cy1inde rs] 


PARTITION START_CYL BLOCKS 

SIZE 

MOUNT PT 


PRESERVE(Y/N) 


a 0 

16048 

8 

/ n, 



b 59 

133456 

17 





c 0 

276896 

141 





d 182 

11696 

5 

/export/root 

n 



e 225 

93840 

48 

/export/swap 

n 



f 0 

0 

0 

/export/exec 




g 570 

87856 

44 

/usr 

n 



h 893 

34000 

17 

/home 

n 



Ok to use this partition table [y/n] 

7 y 




Are you finished with this 

form [y/n] 

7 y 




[x/X=select 

V... 

choice] [space=next choice] ["B/"P=backward] 

[-F/'N=forward] 

. > 


The numbers imder the columns START_CYL, BLOCKS, and SIZE are for this 
example only. The numbers are different for each disk and depend on the exist¬ 
ing label on the specified disk and what you select for partitions d-h. 




If you are installing a heterogeneous server, you must designate a separate par¬ 
tition for /export/exec. This partition is used for exported software which is 
unique to the client architecture type. This is shown above as partition ‘f (in 
listing font), /export/exec should not be defined for homogeneous servers. 
Because the server and client share the same architecture, the client executable 
files are located in the server /usr partition. 


PRESERVE (Y/N) 

PRESERVE, specifies preserving the original disk state. If you answer Y to 
this, you preserve the original filesystem. If you answer N to this you create 
a new filesystem and the data from the original filesystem is destroyed. 

If you alter the starting point or size of a partition, you cannot preserve its 
original state, or any other partition’s state that is forced to be relocated as a 
result of re-partitioning. 




The main menu is displayed when you are finished with the form. 
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Step 5: Assigning Software To assign software information, select assign software information 

Information from the suninstall Main Menu. The Software Form is displayed on the screen. 



For a homogeneous server installation, only fill out a Software Form for the 
server architecture configuratioa On homogenous servers, the server and the 
clients share the selected software; therefore, only one copy is needed. 

For a heterogeneous server installation, fill out a Software Form for the server 
architecture configuration first. When completed, answer n to the question: Are 
you finished with this form [y/n]? Then fill out a Software 
Form for each client architecture type that is different from the server architec¬ 
ture type. This selects the additional software necesary for the client’s differing 
architecture. 


SOFTWARE FORM lDE];,=erase one char of input data] [RET=end of input data] 


Architecture Information : 

Type :[sun2] xlsunB) lsun3x] [sun4] [sun4c] 

Path where executables reside :/usr 

Path where sub-arch dependent executables reside r/usr/lcvm 


Media information; 

Device Type : xfstO] [stl] [st21 [arO] [mtOl [xtO] 
Drive T^e ; * [local] [remote] 


Choice : xtall] [default] [own choice] [required] [cjuit] 


CATEGORY 

NAME 

BYTES 

AVAIL BYTES 

Y/N 

required 

root 

181248 

8216576 

y 

required 

usr 

20971520 

44982272 

y 

required 

Kvm 

2620416 

24010752 

y 

required 

Install 

1153024 

9558037 

y 

desirable 

Sys 

2720768 

21289984 

y 

desirable 

Networking 

853344 

20336640 

y 

^ you finished 

with this 

fom {y/n] ? 

X 



{x/X=select choice] [space»next choice] {''B/"P=backward] ['’F/“N»forward] 


The list of categories to be extracted for the server (sun3) architecture are 
displayed after you make your selection. 
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SOFTWARE FORM [DEL^^erase one char of input data] [RET^end of input data] 


Architecture Information : 

Type :[sun2] x[sun3] [sunSx] [sun4] [sun4c] 

Path where executables reside :/usr 

Path where sub-arch dependent executables reside :/usr/kvm 
Media Information: 

Device Type : x[stO] [stl] tst2] [arO] [mtO] [xtO] 

Drive Type : x[local] [remote] 

Choice : x[all] [default] [own choice] [required] [quit] 


Extract list: 

root 

usr 

Kvm 

Install 

Sys 

Networking 

Debugging 


OK to use the extract list [y/n] ? y 
Are you finished with this form [y/n] ? y 

[x/X-select choice) tspace=^next choice] [''B/'^P^backward] [ "F/"N=forward] 


The suninstall Main Menu is displayed when you exit from this form. 



wsun 

XT microsystems 
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Step 6: Assigning Client 
Information 


To assign client information, select assign client information from 
the suninstall Main Menu. The Qient Form is displayed on the screen. 

Create a client form for each client. 


^[^5 ' For a heterogeneous server, the software for all client architectures must be 
assigned before installing the clients. 


CLIENT FORM [DEL=erase one char of input data] [RET=end of input data] 

Architecture Type : [sun2] x[sun3] [sun3x] [sun4] [sun4c] 

Choice : xlcreate] [delete] [display] [next arch] 

Client<s) : 

tonto 


Client Information : 

Name 

Internet Address 
Ethernet Address 

yp Type : [none] [master] [slave] x[ 

Domain name 

Path of Client^s Root 

Path of Client's Swap 

Path of Client's Executables 

Path of Client's Sub--arch Dependent Execs 

Path of Client's Home 

Swap size (e.g. 8M^8m^8K^8Jc^8 or 8b) 


: tonto 
: 192S.1.1 
: 8 : 0 : 20 : 1 : 00:00 
[slave] x[client] 


home.on,the.rang€ 

/export/root 

/export/swap 

/export/exec/sun3 

/expo rt/exec/kvm/sun3 

/hoxne 

16M 


Are you finished with this form ty/nj ? y . 

[x/X==select choice] [space=next choice] [ "B/"P=baClcward] [ "F/"N=forward] 
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Step 7: Adjusting the lusr After you have selected the software for the server and all clients, return to the 

Partition Disk Form. Add approximately 5-10 Mb to the /us r partition of the server to 

allow for customizing the kernel. 


Step 8: Starting the Installation To start the installation, select start the installation from the j-i/mVi- 

stall Main Menu. 


You are prompted when the tape needs to be changed. If any information is 
missing, the installation will not start. You can go back and assign missing 
information and start again. 


The following messages are displayed after the installation begins: 


- 

System Installation begin : 

Label disk(s) : 
xyO 

File systems check : 

/dev/rxyOa: 140624 sectors in 752 cylinders of 11 tracks^ 17 sectors 

72.0Mb in 47 cyl groups (16 c/g, 1.53Mb/g, 640 i/g) 
super-block backups (for fsck -b#) at: 


32, 3056, 6080, 9104, 

12128, 

15152, 

18176, 

21200, 

24224, 

27248, 


30272, 

33296, 36320, 

39344, 

42368, 

45392, 

47904, 

50928, 

53952, 

56976, 

60000, 

63024, 66048, 

69072, 

72096, 

75120, 

78144, 

81168, 

84192, 

87216, 


Sun3 Installation Begin: 

Creating "root” filesystem 

Extracting ”usr” files from ”/dev/nrst0” release tape 

Extracting ”kvm” files from ”/dev/nrst0” release tape 

Extracting "install” files from ”/dev/nrst0” release tape 

Sun3 installation completed. 

System installation continues... 

File systems check: 


If you do not wish to install a small pre-configured 
kernely you may reboot the system now and 
configure a kernel for your system. 

# 

V_ ^ 
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If you install a SPARCsystem 300 or a Sun-3/80, see the Post-installation Pro¬ 
cedures chapter of this manual for infonnation on how to boot the internal disk 
and modify the boot prom. 


Step 9: Review lsuninstall.log Reviewthe /usr/etc/install/f iles/suninstall. log file. Errors 

File from utilities, such as tar, wiU appear in this file even if they scroll off the 

screen during installation. 


Step 10: Aborting the System Abort the system using ILl-A I for Sun monitors or I BREAK I for tty terminals. 

See the Abort Sequence section of Chapter 3 of this manual for more informa¬ 
tion. 


Step 11: Booting the System 


To boot the system do the following: 



This example shows the installation of a YP master server and therefore must be 
booted single-user. 

>b -a 

. .....L_/ 



The -s argument boots the system in single-user mode. You must boot single 
user before running ypinit when installing a YP master server. 


Step 12: Running ypinit 


While still logged in as root, run ypinit to set up the YP databases. 

- ^ 

# /usr/etc/yp/ypinit -m 


Even if a machine is chosen as a YP server during suninstall, it is stUl necessary 
to run /usr/etc/yp/ypinit on the server before booting clients. After 
doing this, edit /etc/rc. local and remove the comment symbols from the 
lines of code referring to ypbind. If you do not do this, the Yellow Pages will 
not work on the server. 

For information on how to run ypinit and maintain yp databases, see the Sys¬ 
tem and Network Administration manual. 
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Step 13: Completing Post¬ 
installation Procedures 


Complete post-installation procedures as necessary. See Chapter 7 of this 
manual for a list of post-installation procedures. 

If you want to set a root password, see Chapter 5 of this manual. 


microsystems 
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6.6. Local Installation: 
Dataless 


Example Variables: The following variables are used in this walkthrough example. If you are using 

this example as a guide to install your own system, use the device names and net- 
woik information applicable to your system. 

□ hostname: trigger 

□ architecture: sun3 

□ ethemet interface: ieO 

□ system type: dataless 

□ client internet address: 192.9.90.64 

□ server name: nellibell 

□ server architecture: sun4 

□ server internet address: 192.9.90.55 

□ local SCSI tape drive: stO 
a 1 Xylogics eagle disk: xyO 

o yp client of domain: home.on.the.range 

□ software categories: all 


Installation Steps: 


Step 1: Completing Preparatory Complete the Preparatory Local Installation Steps at the beginning of this 
Local Installation Steps chapter. 


Step 2: Starting sminstall 


Start suninstall and enter the proper time zone name and terminal type. 



sun 

microsystenris 
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A---'.- --".". ^ ■■ ■ • ■ .‘.' .‘ ' ■ ". '. '"■■■ ^ ' -N 

# suninstaXI 

Welcome to SuninstaXI 

You are about to install a new version of the SunOS on your system. 

If this is not a first-time installation and you are upgrading from 
a previous version of the operating system^ then it is strongly recom¬ 
mended that you perform a full backup of each of your filesystems 
which contain user data. Be advised that as this program runs, it may 
re-label some of the disk drives and in some cases may initialize new 
filesystems. After this installation process is completei; you may 
restore your user data from backup copies. 

Do you wish to continue with the installation [y/nj? y 

Enter the local time zone name: 

» VStPacific 

Is this the correct date/time [y/n]: 

Mon Mar 14 08:08:57 PST 1988 

Select your terminal type: 

1) Televideo 925 

2) Wyse Model 50 

3) Sun Workstation 

4) Other 

||||iii|||||i|||il|||||||||||||||||i||||||||i^^ 

<-. 


The suninstall Main Menu is displayed. 


^sun 

microsystems 


Revision A, of 25 April 1989 




116 Local Installation: Dataless 


f ---V 

Sun Microsystems System Installation Tool 

Main Menu 

On-line help information prints summary of cursor usage 
+ means the data file(s) exist(s) 

assign host information 

assign disk information 

assign software information 

assign client information 

assign client information 

on-line help information 

start the installation 

exit from suninstall 

[x/X=select choice] [space=next choice] [ "B/''P=backward] [ "F/''N=forward] 

V_ ) 


Step 3: Assigning Host To assign host information, select assign host inf ormation from the 

Information suninstall Main Menu. The Host Form is displayed. 

Enter the hostname of the machine and put an X next to dataless. 



If you are going to install a pre-configured kernel after suninstall has completed, 
answer n to the question: Reboot after completed. For more informa¬ 
tion on pre-configured kernels, see the Post-installation Procedures chapter of 
this manual. 


msun 

Xr microsystems 
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HOST FORM 


CDEL-erase one char of input data] [RET^end of input data] 


Workstation Information : 

Name [Internet Name 0] : trigger 

Type : [standalone] [server] xtdataless] 

Server l^ame ineHibell 

Server Internet Address: 192.9.90.55 

Path of the executables on server: /export/exec/sun3 

Path of the sub-arch dependent executables on server :/export/exec/kvm/sun3 


Network Information : 

Ethernet Interface : [none] x[ie0] 
Internet Address 0 : 192.9.90.64 

Internet Name 0: trigger 
Server Information : 


YP Type 
Doma inname 


: [none] [master] [slave] xtclientl 

: home.on.th€.range 


MisC Information : 

Reboot after completed : xty] [n] 

Are you finished with this form [y/n] ? y 

[x/X“select choice] [space=next choice] ["B/"P=backwardl ["F/"N=forwardl 


The suninstall Main Menu is displayed when you answer y to the last prompt: 
Are you finished with this form [y/n]?. 
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Step 4: Assigning Disk To assign disk information, select assign disk inf ormation from the 

Information sminstall Main Menu. 

The displayed Disk Fomi is different depending on the type of system selected to 
install when filling out the Host Form. The following Disk Form is displayed for 
a Dataless configuration. 


DISK"FORM 


{DEL=erase one char of input data] tRET=end of input data] 


Attached Disk Devices : 
xl xyO] 


Disk Label 


xtedit default] [edit existing] (use data file] 


Free Hog Bisk Partition : 

Id] [e] 

[f] Igl x[h] 


Display Unit 

: ac{Mbytes] 

[Kbytes] [bytes] 

[blocks] [cylinders) 

PARTITION START 

_CyL BLOCKS 

SIZE 

MOUNT PT 

PRESERVE(Y/N) 

a 0 

16048 

8 

/ 

n 

b 

59 

33456 

17 



c 

0 

276896 

144 



d 

0 

0 

0 



e 

a 

0 

0 



f 

0 

0 

0 



h 

0 

0 

0 



Ok to use 

this 

partition table ty/n] 

? y 



Are you finished with this form [y/n] ? y 

[x/X=select choice] tspace=next choice] {''B/''P=backward] t'’F/''N='forward] 



For a dataless configuration, you need only specify / and swap. You can 
specify other partitions as desired except /usr. This is because the server stores 
the usr files for dataless clients. 

The numbers under the columns START_CYL, BLOCKS, and SIZE are for this 
example only. The numbers are different for each disk and depend on the exist¬ 
ing label on the specified disk and what you select for partitions d-h. 



PRESERVE (Y/N) 

PRESERVE, specifies preserving the original disk state. If you answer Y to 
this, you preserve the original filesystem. If you answer N to this you create 
a new filesystem and the data from the original filesystem is destroyed. 
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If you alter the starting point or size of a partition, you cannot preserve its 
original state, or any other partition’s state that is forced to be relocated as a 
result of re-partitioning. 

The main menu is displayed when you exit this form. 

Step 5: Assigning Software To assign software information, select assign software information 

Information from the suninstall Main Menu. The Software Form is then displayed. 



Make sure to select the Install software category. This allows you to convert 
a standalone system to a server at a later date. The Install software contains 
the utilities needed to convert a standalone system to a server and add clients and 
hardware. 


SOFTWARE FORM [DEL==erase one char of input data] [RET=end of input data] 


Architecture Information : 

Type : [sun2] x[sun3] [sun3x] [sun4] [sun4c] 

Path where executables reside : /export/exec/sun3 

Path where siib-arch dependent executables reside ; /export/exec/kvm/sun3 
Media Information: 

Device Type : x[stO] [stl] [st2] [arO] tmtO] [xtO] 

Drive Type : x[local] [remote] 


Choice 

: x[all] 

[default] 

[own choice] 

[required] 

[quit] 

CATEGORY 

NAME 

BYTES 

AVAIL BYTES 

Y/N 


required . 

root 

181248 

8216576 

y 


required 

usr 

20971520 

44982272 

y 


required 

Kvm 

2620416 

24010752 

y 


required 

Install 

1153024 

9558037 

y 


desirable 

Sys 

2720768 

21289984 

y 


desirable 

Networking 

953344 

20336640 

y 



Are you finished with this form [y/n] ? 

[x/x-select choice] [space==next choice] ["B/"P==backward] ["F/^N-forward] 


®sun 

Xr microsystems 
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The list of categories to be extracted for the selected architecture are displayed on 
the following Software Form after you make your selection. 

-___—-- 

SOFTWARE FORM {DEL-erase one char of input data] [RET-end of. input data] 


Architecture Information : 

Type : [sun2] x[sun3] [aun3x] [sun4] [sun4c] 

Path where executables reside ; /export/exec/sun3 

Path where sub-arch executables reside :/export/exec/sun3/kvm 

Media Information: 

Device Type : x[stO] [stl] [st2] [arO] [mtO] [xtO] 

Drive Type : x[local] [remote] 


Choice : x[ali] [default] [own choice] [required] [quit] 


Extract list: 

root 

usr 

Kvm 

Install 

Sys 

Networking 

Debugging 


OK to use the extract list ly/n] ? y 
Are you finished with this form [y/n] ? y 

[x/X=select choice] Ispace=next choice] ["&/"■?—backward] [ "F/"‘N=forward] 


The suninstall Main Menu is displayed when you exit from this form. 
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Step 6: Adjusting the lusr After you select the software, return to the Disk Form. Add approximately 5-10 

Partition Mb to the /usr partition to allow for customizing the kernel. Do this by chang¬ 

ing the numbers using the editor. 


Step 7: Starting the Installation To start the installation, select start the installation from the sunin- 

stall Main Menu. 




You are prompted when the tape needs to be changed. If any information is 
missing, the installation will not start. You can go back and assign missing 
information and start again. 

The following messages are displayed after the installation begins: 


System Installation begin : 

Label disk(s) : 
xyO 

File systems check : 

/dev/rxyOa: 140624 sectors in 752 cylinders of 11 tracks^ 17 sectors 

72.0Mb in 47 cyl groups (16 c/g, 1.53Mb/g, 640 i/g) 
super-block backups (for fsck -b#) at: 


32, 3056, 6080 

r 9104, 

12128, 

15152, 

18176, 

21200, 

24224, 

27248, 


30272, 

33296, 

36320, 

39344, 

42368, 

45392, 

47904, 

50928, 

53952, 

56976, 

60000, 

63024, 

66048, 

69072, 

72096, 

75120, 

78144, 

81168, 

84192, 

87216, 


Sun3 Installation Begin: 

Creating root fileystem 

Extracting ”usr” files from ”/dev/nrst0” release tape 
Extracting ”kvm” files from ”/dev/nrst0” release tape 
Extracting "install” files from "/dev/nrstO” release tape 

Sun3 installation complete. 

System installation continues... 

File systems check: 


If you do not wish to install a small pre-configured 
kernel^ you may reboot the system now and 
configure a kernel for your system. 

# 

V.___> 
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If you install a SPARCsystem 300 or a Sun-3/80, see the Post-installation Pro¬ 
cedures chapter of this manual for information on how to boot the internal disk 
and modify the boot prom. 


Step 8: Review lsuninstall.log Review the /usr/etc/install/f lies/suninstall. log file. Errors 
File from utilities, such as tar, will appear in this file even if they scroll off the 

screen during installation. 


Step 9: Aborting the System Abort the system using ILl-A I for Sun monitors or I BREAK I for tty terminals. 

See the Abort Sequence section of Chapter 3 of this manual for more informa¬ 
tion. 


Step 10: Booting the System 


Step 11: Completing Post¬ 
installation Procedures 


To boot the system do the following: 



Complete post-installation procedures as necessary. See Chapter 7 of this 
manual for a list of post-installation procedures. 

If you want to set a root password, see Chapter 5 of this manual. 
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6.7. Remote 
Installation: 

Standalone 

Introduction The major differences between a remote installation and a local installation arise 

in the method for formatting a disk and copying the minirooL There are only 
minor differences once you are in suninstall. 

Remote installation is required when a workstation with a local disk(s) does not 
have a local tape drive. Two major tasks must be performed, and each of these 
requires the services of another system. 

I. Executing format, copying the miniroot filesystem onto the system disk 
drive, and booting the miniroot filesystem. This task primarily uses the 
client supporting capabilities of the server. 

II. Executing suninstall to install the SunOS. This task primarily uses the tape 
drive capabilities. 

Task I is performed by temporarily making the target system a diskless client. 

To make the target system a diskless client, the services of a temporary server are 
required. The temporary server is known as the remotehost. 

Task n requires the services of a system with a local tape drive which will be 
referred to as the tapehost. The tapehost provides the services of its tape drive to 
copy the miniroot and execute suninstall. 



In most cases, task I and task n utilize the services of same host. It is possible, 
however, for the remotehost and the tapehost capabilities to be taken from two 
different systems. 

I. Primarily uses the diskless client server capabilities. 

II. Primarily uses the tape drive capabilities. 


msun 
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The tapehost and the remotehost must be mnning at least SunOS 4.0 before you 
can perform a remote installation of SunOS 4.0.3. 



If you are installing a tapeless system with a variant sub-architecture, such as a 
Sun-3/80 (Sun-3;c), the tapehost and remotehost must also be running SunOS 
4.0.3 or the remote system will not find its proper sub-architecture dependent 
executables. 

Tapeless Sun-2, Sun-3, and Suns-4 workstations can access any server running 
SunOS 4.0 or later which exports the executables for their architectures. 


Example Variables: The following variables are used in this walkthrough example. If you are using 

this example as a guide to install your own system, use the device names and net¬ 
work information applicable for your system. 

□ hostname (target machine): trigger 

□ architecture: sun4 

□ system type: standalone 

o internet address: 192.9.101.64 

□ remote SCSI tape drive: stO 

□ ethemet interface: ieO 

□ sun4 remotehost: royrogers 

o remotehost internet address: 192.9.101.22 

□ 1 Xylogics eagle disk: xyO 

□ YP client of domain: home.on.the.range 

n software categories: all 

In the following walkthrough example. Executing format and Booting the 
Miniroot covers task I. Task II covers Executing suninstall, the execution of 
suninstall utilizing a remote tape drive. 


:i^ 


Before beginning the remote installation, verify the available disk space of the 
remotehost. It is recommended that you have 20 Mb of available space 
(miniroot+root+swap). 


^sun 

Xr microsystems 
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I. EXECUTING format 
AND BOOTING THE 
MINIROOT 

Step 1: Copying the Miniroot Copy the miniroot from the SunOS release tape set into 

from Tape /export/exec/ client_client_ARCH/local/miniroot on the 

remotehost. 

To do so, mount tape 1 of the SimOS release tape set and do the following: 

- -- 

# int -£ /d«v/nrsrt> r«w 

# mb -f /doiv/axstO £»£ 3 

# dd L£=/dav/xstO bs=I200b of=/axport/ttxac/sun<^/local/mlnlroob 

V_____/ 



Another suitable directory, such as /home/remotehost, can be used if disk 
space is a problem. 




Select the blocksize that is appropriate for your tape device from the following 
table. 


Table 6-1 Blocksize Values 


Tape Device 

Blocksize 

stO 

126b 

mtO 

20b 

mt8 

20b 


Step 2: Setting!etc!hosts and 
letclethers 


If the remotehost (tapehost) is running yellow pages, the YP master 
/etc/hosts and YP master /etc/ethers should contain the target 
machine’s addresses. If the tapehost is not running yellow pages, its local 
/etc/hosts and /etc/ethers should contain the target machine’s 
addresses. 


Step 3: Executing setupjclient 


cd to /usr/etc/install/script. Then execute setup_client to 
create the target machine as a diskless client of the remotehost. 



If the remotehost is running yellow pages, make sure the information added to 
/etc/bootparams on the remotehost is duplicated on the YP master, and the 
bootparams database is remade. 

Depending on the content of the suninstall utilities of the release, you may need 
to create an /etc/exports file if one does not already exist. 
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Step 4: Booting from the 
Remotehost 


For information on executing setup_client, see the Adding and Deleting a 
Client section in the Advanced Installation Issues chapter of this manual. 

Boot from the remotehost in the following way: 

-s 

****For Sun-3 and Sun-4 do the following: 

>b ie (, remotehosthexM) -a 
****For Sun-2 do the following: 

>b ie()-a 
****Then, for all: 

root filesystem type (spec 4.2 nfs):nfs 
root name:<CR> 

Boot:vmunix 

root filesystem type (spec 4.2 nfs):nfs 
root name:<CR> 


swap filesystem type (spec 4.2 nfs) :nfs 
swap name:<CR> 
login: root 

_ ^ _ ! _ 



To determine your remotehost (server) number, do the following: 



The last digit group of the IP address is the remotehost number. The following 
table depicts the location of the remotehost number in several IP addresses. 


IP Address 

Remotehost Number 

192.9.101.8 

8 

192.9.101.22 

22 

192.9.101.102 

102 


To translate the remotehost number into hexadecimal, do the following: 
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maddog% adb 
Otto#=x 


For remotehost 22, it would be: 

inaddog% adb 

0t22=x 

16 (hex of 22) 

maddog% 

_ ! _ 


Step 5: Creating the Disk 
Devices 


Create the disk devices in the following way: 



Step 6: Changing Disk Partition If you want to change the root partition size, decrease the swap partition size, 

Sizes or you have a new disk, execute format to format and label the target 

machine’s disk. 


Step 7: Copying the Miniroot to Copy the miniroot to disk in the following way: 

Disk f -— 

# dd if=/usr/local/niiniroot bs=200b of=/dev/rxyOb 



Select the blocksize that is appropriate for your tape device from the following 
tables. 


Table 6-2 Blocksize Values 


Tape Device 

Blocksize 

stO 

126b 

st8 

200b 

mtO 

20b 

mt8 

20b 


/usr/local/miniroot is the same as 

/export/exec /client ARCH/ local/miniroot because the target 
machine mounts the remotehost /export/exec/client_ARCH on/usr. 
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Step 8: Booting the Miniroot 


0 ^ 

II. EXECUTING suninstall 
Step 1: Editing l.rhosts 

Step 2: Starting suninstall 


Boot the miniroot in the following way: 

-- 

# /etc/halt 

****For Sun~3 and Sun-4 do the following: 

>b ie (, remotehosthexU) -asw 
****For Sun-2 do the following: 

>b ie{)-a 


*^***Then^ for all: 

root filesystem type (spec 4,2 nfs): 4.2 
root device :xyOb 
Boot: vinunlx 

root filesystem type (spec 4.2 nfs): 4.2 
root device: xyOb 


swap filesystem type (spec 4.2 nfs): spec 
swap device [xy5d[a-h]: xyOb 
Swapping on root device, OK? y 



To determine your remotehost (server) number, see Step 4. Booting From the 
Remotehost in this walkthrough. 


Add the target machine’s name to / . rhost s on the remotehost, creating the 
file if it does not already exist. 

Invoke suninstall and enter the proper time zone name and terminal type. 


Asun 

Xr microsystems 
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# sunxnstaXX 

Welcome to SunlnstalX 

You are about to install a new version of the SunOS on your system. 

If this is not a first-^time installation and you are upgrading from 
a previous version of the operating system, then it is strongly recom¬ 
mended that you perform a full backup of each of your filesystems 
which contain user data. Be advised that as this program runs, it may 
re-label some of the disk drives and in some cases may initialize new 
filesystems. After this installation process is complete, you may 
restore your user data from backup copies. 

Do you wish to continue with the installation [y/n]? y 

Enter the local time zone name: 

» lUS/Pacific 

Is this the correct date/time [y/n]: 

Mon Mar 14 08:08:57 PST 1988 


» y 


Select 

your terminal type: 

1) 

Televideo 925 

2) 

Wyse Model 50 

3) 

Sun Workstation 

4) 

Other 

» 3 



V._ J 


The suninstall Main Menu is displayed: 


XT microsystems 
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- 

Sun Microsystems System Installation Tool 

Main Menu 

On-line help information prints summary of cursor usage 
+ means the data file(s) exist(s) 

assign host information 

assign disk information 

assign software information 

assign client information 

on-line help information 

start the installation 

exit from suninstall 

[x/X=select choice] [space=next choice] ["B/"P=backward] ["F/"N=forward] 

V_> 


Step 3: Assigning Host To assign host information, select assign host information from the 

Information suninstall Main Menu. The following Host Form is displayed. 

Select [ standalone ] by putting an x in front of the selection. 



If you are going to install a pre-configured kernel after suninstall has completed, 
answer n to the question: Reboot after completed. For more informa¬ 
tion on pre-configured kernels, see the Post-installation Procedures chapter of 
this manual. 
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HOST FORM [DEL-erase one char of input data] [RET^end of input data] 


Workstation Information : 

Name : trigger 

Type : xtstandalone] [server] [dataless] 


Network Information : 

Ethernet Interface : [none] x[ieO] 

Internet Address 0 : 192SJ0L64 

YP Type : [none] [master] [slave] x[client] 

Domainname : home.onJhe.range 

Misc Information : 

Reboot after completed : x[y] [n] 


Are you finished with this form [y/n] ? y 

[x/X==select choice] [space=next choice] ["B/"P=backward] [ "F/"N=forward] 


You are returned to the suninstall Main Menu when you exit the Host Form. 

Step 4: Assigning Disk To assign disk information, select assign disk information from the 

Information suninstall Main Menu. 

The following Disk Form is displayed for a server configuration. 
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’■KHjKgpgiSHSSHssaSxSsaiSjiSissjjHBKjssssssHjsSif ^ jjaaSvsSasaaaiiaSafasajaiaSKKiaaiaiM::?^ 

DISK FORM [DEL=erase one char of input data] [RET=end of input data] 


Attached Disk Devices : 
x[ xyO] 


Disk Label 


x[edit default] [edit existing] [use 

data file] 

Free Hog 

Disk 

Partition : 

[d] te] 

[f] Cg] x[h] 



Display Unit 


x[Mbytes3 

[Kbytes] [bytes] 

[blocks] 

[cylinders] 

PARTITION 

START_CYL BLOCKS 

SIZE 

MOUNT PT 

PRESERVE (Y/N) 

a 

0 

16048 

8 


n 


b 

59 

33456 

17 




C 

0 

276896 

141 




d 

0 

0 

0 




e 

0 

0 

0 




f 

0 

0 

0 




g 

570 

87856 

44 

/usr 

n 


h 

0 

0 

0 




Ok to use 

this 

partition table ly/xx] 

? y 




Are you finished with this form [y/n] ? y 

[x/X=s6lect choice] [space=next choice] ["B/''P=backward] [*F/“N=forward] 
_/ 


The numbers under the columns START_CYL, BLOCKS, and SIZE are for this 
example only. The numbers will be different for each disk and they depend on 
the existing label on the disk specified. The suninstall Main Menu is displayed 
when you exit from this form. 



PRESERVE (Y/N) 

PRESERVE, specifies preserving the original disk state. If you answer Y, 
you preserve the original filesystem. If you answer N, you create a new 
filesystem and the data finm the original filesystem is destroyed. 

If you alter the starting point or size of a partition, you cannot preserve its 
original state, or any other partition’s state that is forced to be relocated as a 
result of re-partitioning. 


Step 5: Assigning Software 
Information 


You are returned to the main menu when you have finished with the Disk Form. 

To assign software information, select assign software information 
from the Main Menu. The following Software Form is displayed: 
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You must select mtO for 1/2" tape and st 0 for 1/4" tape no matter what your 
actual tape device is. 


SOFTWARE FORM [DEL-erase one char of input data] [RET-end of input data] 


Architecture Information : 

Type : [sun2] [sun3] [sun3x] x[sun4] [sun4c] 

Path where executables reside :/usr 

Path where sub-arch dependent executables reside :/usr/kvm 
Media Information: 

Device Type : x[stO] [stl] [st2] [arO] [mtO] [xtO] 

Drive Type : [local] x[remote] 

Tapehost : royrogers 

Tapehost's Internet Address il92.9J0L22 

Choice : jc[all] [default] [own choice] [required] [quit] 


CATEGORY 

NAME 

BYTES 

AVAIL BYTES 

Y/N 

required 

root 

181248 

8216576 

y 

required 

usr 

20971520 

44982272 

y 

required 

Kvm 

2620416 

24010752 

y 

required 

Install 

1153024 

9558037 

y 

desirable 

Sys 

2720768 

21289984 

y 

desirable 

Networking 

953344 

20336640 

y 


OK to use this extract list [y/n] ? y 
Are you finished with this form [y/n] ? y 

[x/X=select choice] [space=next choice] [ "B/"P=backward] [ "F/"'N=forward] 
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The list of categories extracted for the selected architecture are displayed on the 
form below. 

The form below lists the categories extracted for the Sun-4 architecture. 
SOFTWARE FORM {DEL=erase one char of input data] [RET=end of input data] 


Architecture Type Information : 

Type ; [3un2] [sun3] [sunSx] x[sun4] [5un4c] 

Path where executables reside :/usr 

Path where sub-arch dependent executables reside : /usr/kvra 
Media Information: 

Device Type : x[stO] [stl] [st2] [arO] [mtO] [xtO] 

Drive Type ; [local] x[ remote] 

Tapehost : royrogers 

Tapehost's Internet Address :192SJ01^2 

Choice ; ;c[all] [default] [own choice] [required] [quit] 

Extract list: 

Kvm 

Install 

Networking 


Are you finished with this form [y/n] ? y 

[x/X-select choice] [space-next choice] ["B/"P-backward] [“"F/'N-forward] 


Step 6: Adjusting the lusr After you select the software, return to the Disk Form. Add approximately 5-10 

Partition Mb to the /usr partition to allow for customizing the kernel. Do this by chang¬ 

ing the numbers using the editor. 

Step 7: Starting the Installation To start the installation, select start the installation from the Main 

Menu. 



You are prompted when the tape needs to be changed. If any information is 
missing, the installation will not start. You can abort the installation at any time 
by using [ CTRL-C1 and either restart using the existing information or reassign 
information before restarting. 

The following messages are displayed after the installation begins: 


^ A* 
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- ^ 

System Installation begin : 

Label d.isk(s) : 
xyO 

File systems check : 

/dev/rxyOa: 140624 sectors in 752 cylinders of 11 tracks^ 17 sectors 

72.0Mb in 47 cyl groups (16 c/g^ 1.53Mb/g^ 640 i/g) 
super-block backups (for fsck -b#) at: 


32, 3056, 6080, 9104, 

12128, 

15152, 

18176, 

21200, 

24224, 

27248, 


30272, 

33296, 36320, 

39344, 

42368, 

45392, 

47904, 

50928, 

53952, 

56976, 

60000, 

63024, 66048, 

69072, 

72096, 

75120, 

78144, 

81168, 

84192, 

87216, 


Sun4 Installation Begin: 

Creating root filesystem 

Extracting ”usr” files from ’*/dev/nrst0” release tape 
Extracting ”kvm” files from ”/dev/nrst0” release tape 
Extracting "install” files from ”/dev/nrst0” release tape 

Sun4 installation completed. 

System installation continues... 

File systems check: 


If you do not wish to install a small pre-configured 
kernel^ you may reboot the system now and 
configure a kernel for your system. 

k___> 


If you install a SPARCsystem 300 or a Sun-3/80, see the Post-installation Pro¬ 
cedures chapter of this manual for information on how to boot the internal disk 
and modify the boot prom. 


Step 8: Reviewing suninstall.log Review the /usr/etc/install/files/suninstall. log file. Errors 

from utilities, such as tar, will appear here. 




Revision A, of 25 April 1989 





























136 Remote Installation: Standalone 


Step 9: Removing the Client Once the installation is complete, remove the client partition created for the tar- 

Partition get machine, cdto/usr/etc/install/script and execute 

setup_client using the remove option. 

For more information, see the Adding and Deleting a Client section of the 
Advanced Installation Issues chapter. 



It is recommended that you also remove the client hostname from the . rhost s 
file for security purposes. 


Step 10: Completing Post- Complete post-instaUation procedures, as necessary. See Chapter 7 for a list of 

installation Procedures post-instaUation procedures. 
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Post-Installation Procedures 


This chapter is divided into the following sections: 

□ Booting your SPARCsystem 300 or Sun-3/80 

Directions on booting the internal disk and modifying the boot prom. 

□ Post-installation issues 

Issues you should be aware of before you begin the post-installation pro¬ 
cedures 

o Post-installation procedures 

Post-installation procedures are used to fine tune your system once it is 
installed. Even though a number of the following steps are only applicable 
to systems restoring a customized environment, you should review the entire 
list of procedure steps to determine what you need to do to optimize system 
performance. The procedures in this chapter are suggested for restoring cus¬ 
tomization of the environment. 

□ The Small Pre-configured Kernel 

Explains the small pre-configured kernel and the 

install_small_kernel script. It also defines the configurations sup¬ 
ported by the small pre-configured kernel. 

□ Installing the Small Pre-configured Kernel 

Gives the steps for installing a small pre-configured kernel while in the 
miniroot and while in multi-user mode. 

□ Standard Kernel Configuration Files 

Explains the standard kernel configuration files and their uses. 

□ Configuring a Custom Kernel 

Gives the steps for configuring a custom kernel for a local disk and for disk¬ 
less and dataless clients. 
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7.2. Booting Your 

SPARCsystem 300 or 
Sun-3/80 


Boot Procedure 

Step 1: Halting the System 


Step 2: Booting the Internal 
Disk 


Step 3: Logging in as root 


Step 4: Modifying the Boot 
Prom 



7.3. Post-installation Issues 


The internal disk in both the SPARCsystem 300 and the Sun-3/80, require a spe¬ 
cial booting procedure after suninstall is completed. When suninstall 
is completed, you have the # prompt. The following steps walk you through the 
boot process and the modification of the boot prom. 


Halt the system using the following method. 



Log in as root using the following method. 

- —'— > 

login: su 

Pa 3 s wo rd : type your password 
# 

_ 


Type the following commands to modify the boot prom. These commands need 
to be executed to change the values so you can boot off the internal sd6 device. 
-- 

# eeprom bootdevss'( 0 , 18 , 0 ) 

# eeprom default_boot=''true'' 


You can check the values of the eeprom by typing eeprom and checking the 
results of the two values changed above. 


Before proceeding to the post-installation procedure steps, read the following 
post-installation issues relating to 

o Shared libraries 

□ Freeing disk space 

□ New kernel object files 


wsun 
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Shared Libraries 


Freeing Disk Space 


New Kernel Object Files 


If you receive an error message such as the following after installation, it indi¬ 
cates that the program executed was compiled using a library of a newer minor 
revision level (in this case libc. so. 1.2) than can be found on the system at 
execution time (libc. so. 1.1.1). 

r N 

Id.so: warning: /usr/lib/libc.so.1.1.1 has older revision \ 
than expected 1.2 

V_ ) 


This warning is harmless and can be ignored. New minor releases (i.e. 4.0.3) of 
libraries differ from older ones due to software problem modifications. A major 
release number (i.e. 4.0) indicates a change in interface or functionality, and 
Id. so does not allow a program to execute if a library of the same major revi¬ 
sion cannot be found. For more information, see the Programming Utilities and 
Libraries manual. 

When sunupgrade installs updated shared libraries, it does not overwrite the 
older versions since the file names differ due to the revision number changes. 

The existence of the old libraries does not cause complications as Idconf ig 
and Id. so automatically choose the highest revision of libraries available. You 
may, however, whish to free the disk space used by the obsolete libraries. The 
following example illustrates a method for removing the outdated libraries. 


r 



\ 

# Cd /usr/lib 




# Is libc.s* 




libc.sa*!.1* 

libc.sa.1.2* 

libc.so.1.1.1* 


libc.sa.1.1,1* 

libc.so.1.1* 

libc.so.1.2* 


# rm libc.s?.! 

.1 libc.s?.1.1.1 






.y 


The relationship between the modification dates of the new kernel object files 
shipped with a release and the date that a kernel was last made on a system can 
cause the make utility to incorporate the new object files when a new kernel is 
made. To avoid this potential problem, do the following when eonfiguring a cus¬ 
tom kernel: 

# cd / sya /ARCH/ con f 

# xm -rf ../SYS_NAME 

_ t 


Then type the following immediate before execution: 

---- —- - \ 

# config SYS_NAME 

_ . 


The procedure described above ensures that the newest kernel objects are 
included in the new kernel. 


microsystems 
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7.4. Post-installation 
Procedure Steps 

Step 1: Installing Patch Tapes 


Step 2: Restoring Customized 
Files to /usr 


Step 3: Defining the Correct 
Terminal Type 


Step 4: Adjusting Ordering of 
fsck Passes 


Step 5: Verifying ifconfig 


Step 6: Customizing! etc!exports 


Step 7; Integrating fstab Entries 
Step 8: Merging crontab Files 


Step 9: Configuring a Custom 
Kernel 


Install patch tapes, if applicable. Follow the instnictions that accompany each 
tape. Make sure the patch tapes are for the appropriate SunOS and architecture. 

If you copied customized files as part of the pre-installation procedures, restore 
them now. For example, files from /usr/local and /usr/spool/mail 
may need restoration. 

Edit /etc/ttytab so it has the correct terminal type for the console. 

The default terminal type is Sun. If you are using another terminal type, you 
must edit /etc/ttytab to reflect the correct terminal. The terminal type must 
be known in the termcap database. 

OPTIONAL: Adjust the ordering of entries in / et c / f s t ab to alter the order 
of f sck passes. If you have more than one disk, you may want to re-order the 
fsck passes on the partitions to allow for simultaneous passes. For more infor¬ 
mation, see the System and Network Administration manual. 

Verify the ifconfig lines in / etc/rc. local or /etc/rc .boot to make 
sure they reflect the proper installation of the network. 

For example, make sure the second interface has the correct name. 

Customize and secure /etc/exports as desired. 

For users upgrading from 3.x, this file changed format in 4.x. For more informa¬ 
tion, see the System and Network Administration manual. 

Integrate old fstab entries into /etc/ fstab. Mount the desired filesystems. 

Rim the crontab command. See the crontab (1) man page for more infor¬ 
mation. 

This merges the old crontab entries into the new crontab files. The new 
crontab file is located in /var/spool/cron/crontab/root. Entries 
from the old file can be merged in. They do not include at and syslog entries. 

If you did not install a small pre-configured kernel, configure a custom kernel to 
replace the default GENERIC kernel. See the Installing a Small Pre-configured 
Kernel section in this chapter for information on installing a small pre-configured 
kernel. See the Configuring a Custom Kernel section in this chapter for more 
information on customizing a default GENERIC kernel. 
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Step 10: Running ypinit For YP servers, run ypinit. For more information, see the System and Net¬ 

work Administration manual. 

Step 11: Creating a bootparams If a YP bootparams map does not exist on the YP master, and if you will be serv- 

Map ing diskless clients on the network, create a bootparams map. 

For more information on creating a bootparams map, see the System and Network 
Administration manual. 

Step 12: Checking Desired Check for desired modes on / e t c / dumpdat e s, or other files used by locally 

Modes in Files developed system administration tools. 

Step 13: Checking System REMEMBER: Disk partitions may have changed. Any system scripts that 

Scripts referred to old partitions (i.e. dump and restore scripts, etc.) may need to be 

modified. 

This is especially relevant for software that used to affect client and nd parti¬ 
tions. 

Step 14: Running catman OPTIONAL: If man pages were selected during installation, and there is enough 

disk space, run catman. This program preformats the man pages. 

Step 15: Backing Up the System Make a complete backup of the system following post-installation customization. 

For more information, see the System and Network Administration manual. 

Step 16: Rebooting Clients Reboot aU clients. 
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7.5. The Small Pre¬ 
configured Kernel 

Why Install a Small Pre- The default GENERIC kernel vmunix is automatically installed on your system 

configured Kernel? upon the completion of suninstall or sunupgrade . Because of the new peri¬ 

pherals and software options supported by the default GENERIC kernel in SunOS 
4.x, it is recommended that you replace the default kernel with a small pre¬ 
configured kernel, or a customized kernel to optimize system performance. 

If you are installing one of the systems listed below and do not want to build a 
customized kernel, consider using a small pre-configured kernel. With the added 
enhancements to 4.x, smaller systems using the default GENERIC kernel will not 
perform well. A small pre-configured kernel, called the GENERIC_small kernel, 
eliminates the step of configuring a kernel yourself. 


Architectures That Support 
the Small Pre-configured 
Kernel 


Sun-2: 

o Diskless Sun-2/50 

□ Sun-2/50 with up to two SCSI disks, one SCSI tape 
Sun-3: 

□ Diskless Sun-3/50 and Sun-3/60 

□ Sun-3/50 and Sun-3/60 with up to two SCSI disks, one SCSI tape 
Sun-3x: 

□ Diskless Sun-3/80 

o Sun-3x/80 with up to four SCSI disks 
Sun-4: 

□ Diskless Sun-4/110 and SPARCsystem 300 

□ Sun-4/110 with up to two SCSI disks, one SCSI tape 

□ SPARCsystem 330 with up to four SCSI disks, one SCSI tape 
For All Servers: 

D For a server, you should install a small pre-configured kernel for each appli¬ 
cable client. If the server has a SCSI disk, you can install a small pre- 
configured kernel on its root filesystem, as well as for each applicable client. 

The following table lists the options available in a default GENERIC configuration 
file. More information about individual configurations can be found in 


One version of the pre-configured kernel for smaller systems is available for each 
architecture: Sun-2, Sun-3, Sun-3x, and Sun-4. These files are located in 
/usr/boot/vmunix_small. They are based on the configuration files 
named GENERic_SMALL located in /usr/sys/A/?C///conf. Each stripped- 
down version of the default GENERIC kernel, supports approximately four users as 
applicable by architecture for the following configurations: 
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/usr/sys/A/?C///conf in the files corresponding to the architecture. 


Table 7-1 Small Pre-configured Kernel Files 


Configuration 

Options 

Included in 

GENERIC SMALL 

Description 

INET 

Yes 

Basic netwoiking support 

QUOTA 

Yes 

Disk quotas for local disks 

UFS 

Yes 

Filesystem code for local disk 

NFSCLIENT 

Yes 

NFS client side code 

NFSSERVER 

Yes 

NFS server side code 

LOFS 

No 

Loopback filesystem needed by NSE 

SYSACCT 

Yes 

Process accounting 

SYSAUDIT 

Yes 

C2-level auditing 

IPCMESSAGE 

No 

Sys VIPC messaging facility 

IPCSEMAPHORE 

No 

Sys V IPC semaphore facility 

IPCSHMEM 

No 

Sys V IPC shared memory facility 

TCPDEBUG 

No 

TCP debugging see trpt (8) 

CRYPT 

Yes 

Software encryption 

SP 

No 

Streams pipe 


The To install a small pre-conflgured kernel, the install_small_kernel script 

install_small_kernel is supplied to overwrite the default GENERIC kernel with a smaller version which 
Script is tailored to a selected architecture. The install_small_kernel script 

supports standalone, diskless, and server configurations. Dataless configurations 
are only supported if the script is run following the completion of sunup¬ 
grade. 



The install_small_kernel script should only be run from the miniroot, 
after suninst all is completed. It can also be run from the miniroot or in 
single-user mode after sunupgrade is completed. In both cases, it is important 
that the system not be rebooted before running the install_small_kernel 
script. 


Instructions for using this script are given in the following section: Installing a 
Small Pre-configured Kernel. This section contains instructions for installing the 
small pre-configured kernel in the miniroot, as well as in multi-user mode. 


7.6. Installing a Small Pre- 
configured Kernel 


The installation procedure for installing a small pre-configured kernel can be per¬ 
formed in the following ways: 


From the miniroot, following the completion of suninstall or sunup- 
grade using the install_small_kernel script. 

From single-user mode, following the completion of sunupgrade 
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□ In multi-user mode, manually. 

From the Miniroot: The script used to install a smallpre-configured kernel is the 

install_small_kernel script. You start it from the miniroot after 
suninstall or sunupgrade is completed. 



To install a small pre-configured kernel, DO NOT immediately boot the system 
after suninstall or sunupgrade is completed. For suninstall, this 
means that you must answer no to the following question in the Host Form: 
Reboot after completed? For sunupgrade, the script prompts you 
when the upgrade is complete and teUs you that one of your options is to install a 
smaU pre-configured kernel. 


Step 1: Starting the 
install small kernel Script 


Start the install_small_kernel script in the following way: 



Step 2: Rebooting Your System Reboot your system when you receive the completion message. If the small pre- 

configured kernel is successfully installed on a system, you receive the following 
completion message: 

The small pre-configured kernel has been installed on 
list of systems installed 

You may reboot your system now. 


1 Ll-a I 



If the small pre-configured kernel was not installed after miming the script 
(e.g.none of the questions were answered or an error occurred), you receive the 
following message: 



In this case, you can either reboot your system or mn the 
lnstall_small_kernel script again. 
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Step 3: Removing the Default Once your system is fully operational, you can remove the default GENERIC ker- 
GENERIC Kernel File nel that is saved by the script. 

For a Full Installation: 

If you performed a full installation, use the following command to remove the 
default GENERIC kernel file: 


# rm --f /vmunix.orig 

A 

^. 

. -j 



Make sure your system is running without complications before you remove the 
default GENERIC kernel or the sunupgrade temporary files. If you have prob¬ 
lems with the small pre-configured kernel once you reboot your system, you will 
want to re-install the default generic kernel and then try another installation of 
the small pre-configured kernel. 


For an Upgrade: 

To remove the files created by sunupgrade for the small pre-configured kernel 
installation, use the following command: 


( -^- 

# rm -rf /usr/tit^/flies 

A 




In Multi-User Mode: There are two methods for installing a small pre-configured kernel in mutli-user 

mode: 

□ For standalone, dataless, and server configurations 

□ For diskless client configurations 


Standalone, Dataless, and To install a small pre-configured kernel for standalone, dataless, server and client 

Server Configurations: configurations while in multi-user mode, you must login as root and follow 

the steps listed below. 



Hardware support for the small pre-configured kernel is limited to the 
configurations listed in the Architectures That Support the Small Pre-configured 
Kernel section of this chapter. 


Step 1. Saving the Existing 
Kernel 


Save the existing kernel using the following method: 
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Step 2. Copying the Small Pre¬ 
configured Kernel 


Step 3. Rebooting the System 


Step 4. Removing the Original 
Kernel 



Diskless Client 
Configurations: 

Step 1. Gathering Client 
Information 


Step 2. Saving the Original 
Kernel 


Copy the smaU pre-configured kernel using the following method: 

# ep -p /usr/boot/vmunix_small /vmunlx 
_ 


R&hooi the system using the following method: 



Once your system is fully operational, you can remove the default GENERIC ker¬ 
nel that is saved by the script. 


Make sure your system is running without complications before you remove the 
default GENERIC kernel or the sunupgr ade temporary files. If you have prob¬ 
lems with the small pre-configured kernel once you reboot your system, you will 
want to restore the default GENERIC kernel and then try another installation of the 
small pre-configured kernel. 


- > 

# rm -f /vmunix.orig 



To install a small pre-configured kernel on a server, for its clients, use the follow¬ 
ing steps. 


Gather the following information for each client: 

□ Name of directory on the server containing the root path for the clients. The 
default is /export/root which is used in the example below. 

□ Name of directory on the server containing the kvm path for the client. The 
default is /export/exec/kvm which is used in the example below. 

□ Hostname and architecture of the client which will receive the small kernel. 
For this example, assume client’s hostname is clientname and its architec¬ 
ture is ARCH 

Save the original kernel located in client’s root path: 

.. ... 

# cp -p /export/root/clientname/vniunix \ 
/vmunix/export/root/clientnajna/vinunix. orlg 

.................... . . 
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Step 3. Copying the Small Pre¬ 
configured Kernel 


Step 4. Rebooting the Server 


Copy the small pre-configured kernel from client kvm path to the root path in 
the following way: 


r 

# cp “p /mpoTt/^^<^c/cUent_ARCH/hodt/ \ 

/ vxnunix^sxnal 1 / export / root / cl i cmtnaxne / vmun ix 

L. . . 

J 

Repeat steps 1 through 3 for each client. 


Reboot the server in the following way: 


r .. . ' ' ' . 

# sync 

.A 

# sync 


# reboot 


^. . ... . 

_/ 


Step 5. Removing the Original Once your system is fuUy operational, you can remove the default GENERIC ker- 
Kernel nel that is saved by the script. 



Make sure your system is running without complications before you remove the 
default GENERIC kernel or the sunupgrade temporary flies. If you have prob¬ 
lems with the small pre-conflgured kernel once you reboot your system, you wiU 
want to restore the default GENERIC kernel and then try another installation of the 
small pre-conflgured kernel. 


-—N 

# rm -£ /export/root/clientname/vmimlx.orig 

_ > 


7.7. Standard Kernel Standard kernel conflguration flies for most systems are also available to help 

Configuration Files eliminate some of the steps of configuring a custom kernel. These files are 

designed for minimum editing on selected architectures with t5^ical hardware 
configurations. One of these may be suitable for your system with little or no 
editing. 

On your installed system, the directories /usr /sys /ARCH/ conf contain a 
number of configuration files which are stripped-down versions of the default 
GENERIC kernel configuration file. The files are named according to the hardware 
configurations used; for example, those in /usr/sys/sunS/conf, are listed 
as follows: 
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Sun-2 Standard Kernel 
Configuration Files 


Sun-3 Standard Kernel 
Configuration Files 


r 


DL 


DLllO 


DL50 


DL60 


DL75 


GENERIC 


SDSTllO 


SDST160 


SDST260 


SDST50 


XDMT160 


XDMT260 


XYMT160 


XYMT260 



J 


Files beginning with DL are for diskless systems; SDST files are tailored to SCSI 
disk and tape interface; and XD and XY files support Xylogics equipment. 

Select one that most closely matches your system configuration and build your 
kernel, following the procedure described in the section Configuring a Custom 
Kernel. 

If you need more information on the functions or requirements of each group of 
entries in the file, read the comments provided in the default generic kernel file 
for each architecture. 

The Sun-2 standard kernel configuration files are located in 
/usr/sys/sun2/conf. DL configuration files for diskless Sun-2/50, Sun- 
2/120, and Sun Model 100 (DLIOO, DL120, DL50) support up to four users, offer 
a choice between VME bus and Multibus, and support monochrome only. 

The configuration file named DL is a more general configuration file for diskless 
Sun-2s; it includes all DLxx and DLxxx file entries. 

Color and graphics processing are provided in selected SCSI- and Xylogics- 
support files (XY and SD prefixes), as well in the total-support generic file. 

The Sun-3 standard kernel configuration files are located in 
/usr/sys/sun3/conf . The DL configuration file for diskless Sun-3 systems 
supports all four CPUs, a VME bus, cg4 color graphics, and up to four users. 
Other DLxx and DLxxx files offer various combinations of the above, some with 
color graphics, some monochrome. The DL50 kernel file, for example, could be 
specific for a Sun-3/50 diskless client. 

SDST files support SCSI disk and SCSI tape equipment for the various architec¬ 
tures. 

XDMT and XYMT files are customized for Xylogics controllers and 1/2-inch 
tape, plus SCSI disk and tape. 
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Sun-3x standard kernel configuration files are located in 

/usr/sys/sun3x/conf. DL configuration files for diskless Sun-3x architec¬ 
tures support up to eight users. System VIPC, graphics processing and color 
frame buffer boards are supported. The DL80 file supports an Intel floppy disk 
controller, cg4 color board, keyboard and mouse. 

The Sun-3x GENERIC kernel configuration file includes aU the features found in 
the separate DL, XD, SD, and XY kernel files. The GENERIC file provides a floppy 
disk choice of either SCSI (sfO) or Intel (fdO) standard interface. 

SDST and XYXT kernel files are also provided. 

Sun-4 Standard Kernel The Sun-4 standard kernel configuration files are located in 

Configuration Files /usr/sys/sun4/conf . The DL, diskless, configuration file is the more gen¬ 

eral configuration file for aU Sun-4 architectures and includes the contents of 
DL110andDL330. 

Supporting up to eight users, each configuration file is designed to woik with a 
particular hardware configuration; for example, the XYXT260 provides options 
and functions generally considered likely and suitable for a Sun-4/260 with up to 
two Xylogics controllers and 1/2" tape, plus one or two SCSI disks and one SCSI 
tape. 

As with the other Sun architectures, there are files for all-SCSI devices, and for 
various combinations of SCSI/nonSCSI. 


Sun-3x Standard Kernel 
Configuration Files 


The GENERIC kernel configuration file supports aU hardware configurations. 
Before you use the GENERIC kernel configuration file, you should always edit it. 


7.8. Configuring a Custom This section contains instmctions for configuring a custom kernel. Configuring a 
Kernel custom kernel tailors the kernel to fit your environment and significantly 

improves performance. 

The kernel provided with SunOS 4.x supports many more devices than previous 
releases and is therefore larger than previous kernels. To minimize the amount 
of memory occupied by the kernel, you must comment out unnecessary kernel 
entries. 

The two main reasons for reconfiguring the kernel are: 

1. To free memory that would otherwise be consumed by the unused kernel 
modules. 

2. To tell the kernel about hardware you added after the installation, or 
software packages that require kernel modification and support. 

Configuring a kernel is not a complex task. The GENERIC kernel configuration 
files contain instructions that help you determine which kernel entries are neces¬ 
sary for your system. 



Revision A, of 25 April 1989 



152 Installing the SunOS 4.0.3 


Custom Kernel Configuration 
Procedures 



Procedure I: 


Procedure II: 


Background Information: 


There are two custom kernel configuration procedures presented in this section: 
Procedure I: 

Builds a kernel on a workstation with a local disk. 

Procedure II: 

Builds a kernel on a diskless or dataless client. 


In ALL cases, a kernel must be compiled on a system of the same architec¬ 
ture as the system on which it will be installed. 

The kernel used by a diskless client can be built on its server only if the diskless 
client is of the same architecture as the server. If a diskless client is a different 
architecture than that of the server (heterogeneous), its kernel must be made on 
the client. 


Procedure I is simpler to perform than Procedure II, however, it requires write 
privileges for the /usr filesystem of the woikstation you are configuring. You 
can use Procedure I to build a kernel for any of the following: 

□ A standalone workstation 

□ A server 

□ A diskless client; the same architecture as the server 

o A dataless client; the same architecture as the server 

Procedure II is more complex than Procedure I, however, it allows you to build a 
kernel without having write privileges for the /usr filesystem of the workstation 
you are configuring. You can use Procedure II to build a kernel for any of the 
following: 

□ A diskless client; different architecture from the server 

□ A dataless client; different architecture from the server 

□ Diskless or dataless client without root privileges on the server 

Before you configure a custom kernel, you must have installed SunOS 4.x using 
suninstall, or upgraded to SunOS 4.0.3 using sunupgrade. All custom kernel 
configuration procedures are performed when logged in as root, or superuser. 

SYS_NAME, as shown in the following example screens, represents the name 
given to the custom kernel configuration file. It is typically chosen to match the 
hostname of the workstation that will run the kernel. The name is automatically 
compiled into the kernel and is announced when the kernel is booted. For exam¬ 
ple, a kernel made from a configuration file named maddog announces itself 
when booted as follows: 


•sun 

Xr microsystems 
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-- 

SunOS Release 4.0.3 (MADDOG) #1: Wed Sep 14 15:33:16 PDT 1988 
s_> 


A kernel used by several client woikstations of a server might be called 
MADDOG_CLIENT. 

CONFIG_FILE, as shown in the following example screens, represents the name 
of the configuration file that you edit for customizing your kernel. While GEN¬ 
ERIC is the default configuration file (i.e. contains all possible hardware and 
software supported by the operating system), it is easier to start by using a file 
similar to your hardware configuration needs. For example, use DL for diskless 
clients. See the Standard Pre-configured Kernel Files section in the Small Pre¬ 
configured Kernel section of this chapter. 

The ARCH variable in the example screens which follow show you where to 
enter your appropriate woricstation architecture: sun2, 8un3, sun3x, 
sun4 or sun4c. Use the workstation architecture for the workstation on which 
you are building the kernel. 



If you are not sure of the architecture of your system, type the following com¬ 
mand. The architecture of your system will be displayed. 


r 

N 

% ARCH -k 


sun3 


V . 




If you are configuring a server, you must also configure the kernels for each disk¬ 
less and dataless client. 


Procedure I: For a Local Disk The following procedure shows you how to build a custom kernel for a local 

disk. 


Step 1: Creating a Kernel Log in as root and execute the following: 

Configuration File 
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Step 2: Installing the 
Configured Kernel 


f - 

# cd /usr/sys/A/SfC^r/conf 

# cp CONFIG_FILE SYS_NAME 

# chmod +w SYSJIAME 

# vi SYS_NAME 

A 

(Comment out unneeded kernel modules) 


# eonfig SYS_NAME 

# cd .JSYSJNAME 

# make 

. . . 

.y 


When the make is complete, install the kernel using the next step. 

The method for installing a configured kernel depends on the configuration of the 
workstation the kernel was built on. The following three methods are presented 
for installing a configured kernel. 

□ Standalone or server workstation 

□ Diskless client of the same architecture as the server 
o Dataless client of the same architecture as the server 
Standalone or Server: 

To install the kernel on a standalone or server workstation, use the following 
method. 

—^ 

# mv /vmunix /vmunlx.orig 

# cp vmunlx /viminix 

N_✓ 


Diskless Client: 

To install the kernel on a diskless client workstation of the same architecture as 
the server, use the following method. 

^^ 

# wv /«ac|>ort/root/Sy5_A64M£/vxttuniac /axport/rcot/ \ 

SFSJVAME/vmunix. orig 

# cp vxnunix /export/root/SFS^iVAME/vmunix 


Dataless Client: 

To install the kernel on a dataless workstation of the same architecture as the 
server, log onto the dataless workstation as root and use the following method. 

# mv /vmunix /vmunix.SV 

# cp /usr/sysM/?Cff/SySJVAM£^/vmunix /vmunix 
-/ 
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Step 3. Halting and Rebooting 
the System 


Procedure H: For Diskless or 
Dataless Clients 



Step 1. Creating the 
Configuration File 


Step 2. Configuring and Making 
the Kernel 


Once you have installed the kernel, halt and reboot the system in using the fol¬ 
lowing method. 



The following procedure shows you how to build a kernel for a diskless or data¬ 
less client. 

The following example makes the kernel in the /sys directory of the client. 
The client’s /sys file is located in the /export/root filesystem of the 
server. 


You must have at least two megabytes (2 Mb) of disk space available to make a 
kernel. If the space is not available in the /export/root filesystem, the pro¬ 
cedure can be done in any other filesystem which has sufficient space and is writ¬ 
able by the client. 

Log in as root and execute the following. 

# mkdir /horm/hostname 

# cd /home/hostname 

# In -s /usr/sys/* . 

# rm ARCH 

# mkdir ARCH 

# cd ARCH 

# In -s /nsr/sys/ARCH/* . 

# zm conf 

# mkdir conf 

# cd conf 

# In -s /visr/sys/ARCH/conf/* , 


Configure and make the kernel using the following method. 


— 

# cp CONFIG_FILE SYSJSfAME 

# chmod +w SYS_NAME 

# vi SYS_NAME 

.^ 

(Comment out unneeded kernel modules) 


# config SYSJMAME 

# cd , . /SYSJfAME 

# make 


^_ 

y 


^sun 
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Step 3. Installing the Kernel When the make completes successfully, install the kernel using the following 


method. 

✓ 

# mv /vmunix /vmunix.orig 

# cp vmunix /vmunix 

- \ 

V 

. j 


Step 4. Halting and Rebooting 
the System 


Once you have installed the kernel, halt and reboot the system in the following 
way. 



Step 5. Cleaning Up the After the client has successfully booted, save a copy of your customized 

Filesystem configuration file and then clean up / sy s using the following method. 
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Advanced Installation Issues 


8.1. Introduction This chapter covers installation issues for the advanced user. You can consider 

yourself an advanced user if you have a basic understanding of system adminis¬ 
tration issues and have installed several system configurations. 

This chapter covers the following information: 

□ The /export Filesystem 

□ The setup_exec and setup_client utilities 


8.2. The / export The /export filesystem is the Sun standard filesystem for the location of the 

Filesystem executable files for diskless clients. When converting a standalone system to a 

server, you must allow for enough space in this filesystem for all clients. You 
can provide for an /export filesystem in suninstall on the Disk Form. 


It is important to allow enough disk space for the /export filesystem. For each 
new architecture, allow approximately 75-100 Mb for /usr files and between 
28-75 Mb for each workstation client. LISP requires approximately 40 Mb 
swap area for each client. 

If you did not define an /export filesystem when installing your system, you 
can do so later by using the setup_exec utility. When using setup_exec 
in this case, do not indicate that you want an execpath or a kvmpath attached 
to /export. If you do, setup_exec will place /export in the root 
filesystem and create a disfunctional situation. In this case, select another direc¬ 
tory to attach the new files to. Use the same process for setup_client, 

Remember to review the files in /etc/exports and the client /etc/f stab 
files to make sure the server files can be mounted by their clients and that the 
clients are making the correct moimts. Client /f stab file is normally found in 
/export/ root/clientname/ etc. 


159 Revision A, of 25 Ajjril 1989 









1 60 Installing the SunOS 4.0.3 


Adding a Second Disk for an If you are planning on expanding your system with another disk drive, you may 
/export Filesystem want to consider allocating an entire disk for the /export filesystem. Do this 

using the format utility and repartition the second disk into one partition. 



It is advised that you only use a Sun disk system for this purpose due to the spe¬ 
cial peripheral files that scan for Sun specific products. 


Step 1: Making the Device 
Step 2: Formatting the Disk 


Step 3: Running newfs 


Step 4: Entering the Mount 
Point 


The following steps illustrate how to add a second disk for an /export filesys¬ 
tem, to make the conversion to a server from a standalone system. 

Make the device for your disk drive in the / dev directory using MAKEDEV. 

Start the format utility and repartition the new disk. Make a note of the parti¬ 
tions for their relative sizes. 

For more information on how to use format, see Beginning the Installation, 
Chapter 4 in this manual. 


Run newf s for each partition using the following method. 



Enter the mount for new drive in /etc/f stab. 


Step 5: Mounting the New Drive Mount the new drive using the following method. 

If you need a mount point, make the directory before mounting the drive. 

# mount -a disk 


Step 6: Adding Architecture If you are adding a client that is a sub-architecture of the server (i.e. adding a 

Dependendent Files Sun-3x client to a Sun-3 server), only to add the kvm and sys files. 

If you are building a heterogeneous system, you need to run setup_exec to 
construct links create an / etc/exports file. You do not need to select 
software, local/remote, or tape type. 

-— ,, 

host# cd /usr/atc/in stall 

host# setup^exoc sun4 /export/exec/sun4 /export/execAvm/sun4 
host# setup_exec sunBx /export/exec/sun3 /export/exec/kvm/sun3x 
V___ J 
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8.3. The setup 
and setup 

Utilities 

setup_exec 


exec setup_exec and setup_client are the main utility commands used 

client throughout the rest of this chapter. The following sections explain each of these 
utilities and their uses. 

setup_exec is a utility that allows you to install additional software cfter an 
installation is completed. It is specifically used when converting a standalone 
system to a server by adding the client architecture executable files if they are 
different from that of the server. 

For example, if you have a Sun-4 standalone system running SunOS 4.x and you 
want to convert it to a server that supports both Sun-3 and Sun-4 clients running 
SunOS 4.x, run setup_exec to install the Sun-3 executable files on the sys¬ 
tem. You do not need to install Sun-4 executable files since the system you are 
converting to a server is a Sun-4 and is running SunOS 4.x, in which case, the 
Sun-4 executable files are already in place. 



Beginning with SunOS 4.0, extract_release is no longer available as a 
method to extract additional software. You must use setup_exec. 


The following example illustrates the usage of setup_exec. 


r \ 

host# SAtupjaxac 

usage: setup_ 

exec arch execpath kvmpath [-s] 

where arch 

= sun2, sun3^ sun3x, sun4, sun4c 

execpath 

« full pathname of client executables 
<e.g. /export/exec/sun3) 

Icvmpath 

* full pathname of sub-arch dependent executables 


{e.g. /export/exec/kvm/client_arch) 

[-S3 

- optional; rewind tape every time 

host# 

V_ 
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OPTIONS 

□ arch 

The architecture of the client executable files you want to install. 

□ execpath 

The location of the client executable files. The Sun standard is 
/export/exec /client ARCH. 

□ kvmpath 

The location of the client sub-architecture dependent executable files. The 
Sun standard is /export/exec/kvm/ client_ARCH. 


When the you add the first client to a standalone system you must add /usr and 
the client’s "home" filesystem to /etc/exports. After this is completed, 
execute exportf s -a or reboot the server. 

The following example shows the addition of the executable files and kvm files 
for a Sun-3 client. 

^ ^ ^ ^ ;■ . ^ 

host# stttupjMCttc svin3 /«xport/«Kttc/sun3 /«](|>ort/«3tttc/kvin/sun3 

I,_^ 


You are then prompted for tape drive information, much in the manner of the 
suninstall Software Form. See the setup_exec manual page in the Reference 
chapter of this manual for more information. 


setup_client setup_client is a utility that allows you to create or remove diskless clients. 

The setup_client utility is located in 


/usr/etc/install/script/setup_client 

If you are not already in the directory, do the following before running 
setup_client. 



See the setup_client man page in the Reference chapter of this manual for 
more information. 



You must add the client to the /etc/hosts and /etc/ethers files on the 
server or the YP master before to running setup_client. The YP maps 
must also be pushed, or distributed to all YP slave servers. 

For the first client added to a standalone system converted to a server, start 
bootparamd after running setup_client. This can be done by either exe¬ 
cuting /usr/etc/rpc. bootparamd or rebooting the server. The 



Revision A, of 25 April 1989 




Chapter 8 — Advanced Installation Issues 163 


commands for both a local taped drive and a remote tape drive are exactly the 
same. 

The following example illustrates the usage of setup_client. 


host# sattip^cliont 

set-up^client: incorrect nuinber of argiainents. 
usage: 

setup_client op clientname yp_type size rootpath swappath homepath execpath arch 
where: 

« ’’add" or "remove" 

= name of the client machine 
'master" or "slave" or "client" or "none" 

- size for swap 

(e.g. 16M or 16in ~> 16777216 bytes 
16K or 16k 16384000 bytes 

16B or 16b ~> 31250 blocks 

- parent pathname of client root <e.g. 

« parent pathname of client swap (e.g. 

* parent pathname of client home <e*g^ 

= full pathname of client executables 

(e^g. /export/exec/sun2/ /export/exec/sun3^ etc) 

= full pathname of client sub'-arch dependent executables 
(e.g* /export/exec/kvm/sun3x) 


op 

name 

yp_type 

size 


rootpath 

swappath 

homepath 

execpath 

kvmpath 


/export/root) 

/export/swap) 

/home r remotehost:/home) 


arch 


^e.g* /exporc/exec/xvm/sun^x; 

"sun2’’ or ’’sun3” or "sun3x” or ”sun4” or ”sun4c” 


host # 


Options 


□ add or remove 

Add or remove a client from the server. 

□ name 

The hostname of the client, 

o yp 

The yp type of the client. 

□ size 

The size of the swap space in bytes reserved for the client 

□ rootpath, swappath, homepath 
The locations of the client directories. 
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□ execpath 

The location of the client architecture dependent executables 
(/export/exec/ client_ARCH). 

□ kvmpath 

The location of the client sub-architecture dependent executables 
(/export/exec / kvm/c/ienr_A/?C//)- 

□ arch 

The client’s architecture type. 



If you are adding a client, setup_client sets up client information under 
the directories you specify. 

If you are removing a client, setup_client removes the client information 
under the directories you specify. 


The following table illustrates the Sun standard entries for setup_client. 


Table 8-1 Client Pathnames 

Pathname Created on Server 

Pathname Entered in setupjexec 

lex^Tt/root/clientname 

/expoTt/swapIclientname 

IcxpOTt/homc/clientname 

/expon/Qxec/client_ARCH 

/export/exec/kvm/c/je«r_A/?C// 

/export/root 

/export/swap 

/home 

lexpoTtjQxeclclient_ARCH 

lexport/cxcc/kvmlclientARCH 


setup_client Examples The following examples illustrate the use of setup_client for adding and 

removing a client. 

Adding a Sun-4 Qient The following examples illustrates the use of setup_client in adding a Sun- 

4 client named astro. 

( -^ 

host# satup_cllent add astro cliant 16K /axport/root \ 

/a3q>oxt/8wap /homa /axport/axac/sun4 \ 

/axport/axac/kvm/sxm# sun4 

V > 
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Removing a Sun-3 Qient 


The following example illustrates the use of setup_client in removing a 
Sun-3 client named fred, 

- 

hoali# satup^cllent remove fred client 1€ /export/root \ 

/export/swap /home /export/exec/simB \ 

/export/exec/kvm/sunS sunS 

Vs_/ 


microsystems 


Revision A, of 25 April 1989 




9 


Performing a System Upgrade 

Performing a System Upgrade. 169 

9.1. Introduction. 169 

9.2. Upgrade Features. 170 

9.3. Which Files Are Replaced During an Upgrade?. 170 

Upgrading User-Customized Files. 170 

9.4. Backgroimd Information. 171 

Planning for Disk Space. 171 

sunupgrade. 171 

sunupgrade Assumptions. 172 

Assumptions for Servers . 172 

Assumptions for Dataless Clients . 172 

Sun-2 Support. 172 

Work Around: Client Files Not in One Directory Tree. 173 

For Client exec Directories: . 173 

For Client root Directories: . 174 

9.5. Before You Begin. 174 

For AU Installations:. 174 

For Remote Tape Installations:. 175 

Adding Additional Software After Upgrading. 175 

9.6. Upgrade Summary. 176 

9.7. Upgrade Walkthrough Examples. 177 

Introduction. I 77 

9.8. Local Upgrade: Standalone. 178 




























Example Variables:. 178 

Before You Begin;. 178 

InstaUation Steps:. 178 

Step 1: Backing Up All Filesystems . 178 

Step 2: Verifying Disk Requirements . 179 

Step 3: Halting the System . 179 

Step 4: Copying the Miniroot . 179 

Step 5: Starting the Upgrade . 179 

Step 6: Rebooting the System . 181 

Step 7: Mounting Local Filesystems . 181 

Step 8: Checking Special Files . 182 

Step 9: Customizing and Installing Special Files . 182 

Step 10: Configuring a Custom Kernel . 182 

Step 11: Booting in Multi-User Mode . 183 

9.9. Local Upgrade: Heterogeneous Server. 184 

Example Variables:. 184 

Before You Begin:. 184 

InstaUation Steps:. 185 

Step 1: Halting All Clients . 185 

Step 2: Backing Up All Filesystems . 185 

Step 3'.Verifying Disk Requirements . 185 

Step 4: Halting the System . 186 

Step 5: Copying the Miniroot . 186 

Step 6: Starting the Upgrade . 186 

Step 7; Rebooting the System . 190 

Step 8: Mounting Local Filesystems . 190 

Step 9: Checking Special Files . 191 

Step 10: Re-Customizing Local Files . 191 

Step 11: Examining Client fstab Entries . 191 

Step 12: Configuring a Custom Kernel . 192 

Step 13: Booting in Multi-User Mode . 192 

9.10. Remote Upgrade: Dataless. 193 

Example Variables:. 193 

Before You Begin:. 193 

InstaUation Steps: . 194 






































Step 1: Backing Up All Filesystems . 194 

Step 2: Verifying Disk Requirements . 195 

Step 3: Halting the System . 195 

Step 4 : Copying the Miniroot . 195 

Step 5: Starting the Upgrade . 195 

Step 6: Rebooting the System . 197 

Step 7: Mounting Local Filesystems . 197 

Step 8: Reconciling User Customized Files . 198 

Step 9: Re-Customizing Local Files . 198 

Step 10: Configuring a Custom Kernel . 198 

Step 10: Booting in Multi-User Mode . 199 

9.11. Remote Upgrade: Standalone. 200 

Example Variables:. 200 

Before You Begin:. 200 

Installation Steps:. 201 

Step 1: Backing Up All Filesystems . 201 

Step 2: Verifying Disk Requirements . 201 

Step 3: Halting the System . 202 

Step 4 : Copying the Miniroot . 202 

Step 5: Starting the Upgrade . 202 

Step 6: Rebooting the System . 204 

Step 7: Mounting Local Filesystems . 204 

Step S.Reconciling User Customized Files . 205 

Step 9: Re-Customizing Local Files . 205 

Step 10: Configuring a Custom Kernel . 205 

Step 11: Booting in Multi-User Mode . 206 
































Performing a System Upgrade 


9.1. Introduction You must use the OS 4.0.3 Upgrade tape to perform a system upgrade. It is 

the only tape that provides the files for a system upgrade. 

The sunupgrade utility is the program used to perform a system upgrade. A 
system upgrade, selectively replaces the files that have changed between the 
release you are running and the new release to which you are migrating. 

/usr/etc/sunupgrade exists in the miniroot on the OS 4.0.3 Upgrade tape. 
Once these files are copied over to disk, you can run the sunupgrade utility to 
perform a system upgrade. The sunupgrade utility provides the necessary 
files to upgrade your system from SimOS 4.0 or later. The upgrade process is 
straight forward with a user interface that requires a minimum of input informa¬ 
tion. It automatically saves user-customized files in a special directory so you 
can translate your customizations to the new files. 

During the upgrade process, sunupgrade prompts you for the following infor¬ 
mation: 

□ Tape controller type 

□ Local or remote installation 

□ Disk device of the root partition 

□ Any changed directory names, if you are upgrading a server 

□ Other information, particularly if performing a remote installation 

If you are currently running SunOS 3.x and want to migrate to SunOS 4.0.3, you 
must perform di full installation. See Chapters 2, 3,4, and 5 in this manual for 
information on performing a full installation. 

As in previous releases, it is strongly recommended that a server be of an 
equal or more powerful architecture than its clients. 
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9.2. Upgrade Features The sunupgrade utility contains the following features: 

□ The sunupgrade utility is available for aU configurations on the following 
architectures: Sun-2, Sun-3, and Sun-4. AU Sun-2, Sun-3, and Sun-4 clients 
of a server are upgraded to SunOS 4.0.3. 

□ Checks the existing software files instaUed on your system against the new 
upgrade files and automatically instaUs the new files. 

□ AutomaticaUy saves and labels user-customized files. 

□ AUows for client files and directories that do not conform to Sun standards. 

□ The /sbin/conf ig and /usr/etc/upgrade files are unique to the 
OS Upgrade. 

□ sunupgrade now runs in a “no rewind” mode by default, greatly speeding 
system upgrades. 

□ When upgrading a dataless client, sunupgrade checks to see whether the 
server has already been upgraded to the same release. If not, sunupgrade 
will not let you upgrade the dataless client. 

□ The sunupgrade utility automatically builds data files for the 
install_small_kernel script. 

□ The 1/4" tape device is stO. This takes advantage of the auto-density selec¬ 
tion in the st driver. 


9.3. Which Files Are When you migrate to SunOS 4.0.3, sunupgrade checks the software 

Replaced During an categories you have instaUed on your system and replaces those files that are dif- 

Upgrade? ferent between the release you are running and the upgrade release. 

To create a log of the files extracted an overlaid during the upgrade process, use 
the -1 option when running sunupgrade. The log of files you create is saved 
in the /usr/etc/upgrade/save directory. For more information on this 
option, see the upgrade ( 8 ) manual page in the Reference chapter of this 
manual. 



Only those optional software categories which were previously instaUed on your 
system are affected by the upgrade. 


Upgrading User-Customized User-customized files, such as those in /etc and / var are preserved during the 

Files upgrade, sunupgrade checks the software instaUed on your system and 

instaUs the new files in their respective directories with a trading suffix so they 
are clearly distinguishable from the existing files. A list of these files is main¬ 
tained in the directory /usr/etc/upgrade/save in the foUowing files: 

□ special_f lies for standalone, server, and dataless cUents 

□ <clientname>. special_f lies for diskless clients 
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o /home/upgrade/special_f lies for dataless clients 

You must copy the customizations from your existing files to the new files. 

Then, rename the old files to filename. old and the new files to filename. 

For example, anew /etc/rc. local file is installed as /etc/rc. local- 
4.0.3. The old rc. local file remains unchanged. You should inspect the 
differences between the two files and change the new rc. local file to reflect 
the site or user-specific changes of the old r c. local file. After editing the new 
files, rename rc. local to rc. local. old, and rc. local-4.0.3 to 
rc. local. 



The dif f (1) utility is useful for comparing the old and new files. 


9.4. Background 
Information 


The following information is essential to understanding the upgrade process. 
Review this information carefully before you begin the upgrade procedure. 


Planning for Disk Space Upgrading your system requires the temporary use of additional disk space. If 

the required disk space is not available when you run sunupgrade, it can cause 
the upgrade to faU. 


sunupgrade 


As a general rule of thumb, allow 2-3 Mb of free disk space for each partition 
that it writes into. 



Verify that there is 2-3 Mb of free disk space on the /, /usr, /var, /export, 
/root, and /exec partitions. Also verily that any client root and /usr, 

/ export/root, and / export/share partitions have 2-3 Mb of available 
space. 


sunupgrade uses disk space in the following ways: 

□ Disk space is used temporarily when sunupgrade replaces old files with 
new files. The old files are not removed until the new files are in place and 
labeled with the correct names, thus creating a temporary demand for disk 
space equal to the size of the new files. This is important to note, since 
many executable files exceed 1 Mb thus creating a temporary demand for 
storage in excess of 1 Mb. 

□ Disk space is used when sunupgrade saves old versions of files in addi¬ 
tion to the new versions. In particular, the old kernel, vmunix, is renamed 
and a new GENERIC kernel is installed in its place. This alone consumes 
approximately 1 Mb of disk space. To a lesser degree, old versions of /etc 
and /var require disk space when saved. 
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o Disk space may be used to create working files and append log entries to 
special_flies. 

□ sunupgrade extracts software categories from the distribution tape based 
on the existence of certain representative files. If you have previously 
installed a software category, and not completely deleted its component files, 
sunupgrade may re-extract the entire software category, therefore using 
up free disk space. 



If your upgrade fails due to lack of disk space, allocate more disk space in the 
required areas and re-run sunupgrade. If restarted, sunupgrade simply 
overwrites any files it wrote in the first attempt. 


sunupgrade Assumptions SunOS 4.x allows considerable flexibility in naming and locating important parti¬ 
tions and directories when configuring clients and servers. Sun recommends cer¬ 
tain conventions in these areas, however, some sites choose to differ from Sun 
conventions. 

sunupgrade makes important assumptions about the location and use of key 
directories listed below. If your site does not follow Sun conventions in these 
cases, you must implement the suggested work arounds. 


Assumptions for Servers 


Assumptions for Dataless 
Clients 


AH client root directories are assumed to be in one directory. The Sun conven¬ 
tion for client root directories is /export/root, sunupgrade prompts 
you for the pathname to this directory during the upgrade process. If your client 
root directories are not organized in one directory, use the work around in the 
next section when upgrading, sunupgrade assumes that all client root direc¬ 
tories can be reached from one client root pathname to be upgraded: either 
directly or via symbolic link. 

All client /usr directories are assumed to be under one directory. The Sun con¬ 
vention for client /usr directories is /export/exec, sunupgrade 
prompts you for the pathname to this directory during the upgrade process. If 
your client /usr directories are not organized in one directory, use the woik 
around in the next section when upgrading, sunupgrade assumes that client 
/usr directories can be reached from one client /usr pathname to be upgraded; 
either directly or via symbolic link. 

All /usr directories are assumed to be resident on the server and mounted from 
the server on the client over NFS. All other root partitions are assumed to be 
local to the dataless client. 


Sun-2 Support 


AH Sun-2 clients of a server can be upgraded to SunOS 4.0.3 for aH server 
configurations. 


wsun 
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On a heterogeneous server, Sun-2 clients now mount /export /share onto 
their /usr/share partitions, and not /export/share. sunos4.0. 
sunupgrade automatically updates the /etc/f stab files of all existing 
Sun-2 clients on a server that was upgraded to SunOS 4.0.2 using sunupgrade. 


Work Around: Client Files This section explains how to create links to client root and exec directories 

Not in One Directory Tree that do not conform to Sun conventions. Sites which do not adhere to the Sun 

convention of placing client root and exec files in one directory tree should do 
the following before running sunupgrade. 

For Client exec Directories: Select the partition which contains most of the client executables as the primary 

exec directory. Then, create a symbolic link in the primary exec directory for 
every exec directory not in the primary directory. 

For example, if /export /exec is your primary client exec directory and the 
server is a Sun-3, the following example shows how to verify the existence of the 
/export/exec/sun3 directory. 

f -N 

toots% file /eaqport/exec/* 

.sun3: symbolic link to /usr 

lost+found: directory 

V_/ 


If you previously installed exec files for a Sim-4 client in /home/somedir, 
you need a symbolic link from the primary client exec directory. The following 
example shows how to verify the existence of the /home/somedir/sun4 
directory. 

r ^ ^ 

toots% Is /home/somedir 
sun4 

toots% file /hoine/somedir/sun4 
.sun4: directory 

_ / 


The following example shows how to set up a symbolic link. This guarantees that 
sunupgrade will be able to find the client executables by following the sym¬ 
bolic link. 


r 

toots% 

cd /expcrt/exec 

N 

toots% 

In -s . . / . . /hoine/somedir/sun4 


toots% 

file * 


sun3: 

symbolic link to /usr 


sun4: 

symbolic link to ../../home/somedir/sun4 


^. 


. J 


Unless you are in multi-user mode, pathnames should be preceded by the mount 
point ( /a). 
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For Client root Directories: Select one directory as your primary client root directory and set up links for 

entries that are not in the primary directory. Use the same method as described 
above for the exec files. This guarantees that sunupgrade will be able to find 
the client by following the symbolic links. 

For example, if /export/root is your primary client root directory and 
contains clients whammo and zappo, while client glitchy is in directory 
/someother, your primary client root directory should look as follows: 

- -- 

toots% file /export/root/* 

whanano: directory 
zappo: directory 

glitchy: symbolic link to ../../someother/glitchy 
V_> 


9.5. Before You Begin □ sunupgrade runs in a no rewind mode by default, greatly speeding 

system upgrades. Running sunupgrade from the SunOS 4.0.3 miniroot 
always allows for the no rewind operation. However, a remote installa¬ 
tion from a tapehost running a release prior to SunOS 4.0.3, disables the no 
rewind operation. You can explicitly disable the no rewind operation 
by starting sunupgrade using the -n flag: 



a The sunupgrade utility automatically builds data files for the 

install_small_kernel script. This script can be run after sunup¬ 
grade is completed and before rebooting the system. The 
install_small_kernel script installs a small pre-configured kernel on 
your system. For more information on which systems support the small 
pre-configured kernel and how to install it, see the Post-installation Pro¬ 
cedures chapter in this manual. 

For All Installations: Gather the following information before you begin the upgrade. 

□ The Disk Device of the root Partition 

Know the disk device that the root ( / ) partition resides on. The follow¬ 
ing table lists the available disk device types supported by this upgrade. 


Device 

Description 

xy 

Xylogics 450/451 SMD disk controller 

xd 

Xylogics 7053 disk controller 

sd 

SCSI disk controller 


□ Tape Controller Type 

Know the system’s tape controller type. The following table lists the sup¬ 
ported tape controller types. 
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For Remote Tape 
Installations: 


Adding Additional Software 
After Upgrading 


Controller 

Description 

mt 

Tapemaster Nine-track 1/2" tape 

xt 

Xylogics Nine-track 1/2" tape 

St 

SCSI 1/4" cartridge tape 


If you are performing an installation over the network from a remote tape drive, 
gather the following information before you begin the upgrade: 

o Tapehost Hostname 

Know the hostname of the machine with the tape drive (the tapehost). 

□ /etc/hosts 

Ensure that the /etc/hosts file of the machine that you are updat¬ 
ing includes the Internet address and hostname of the tapehost. 

□ /.rhosts 

Ensure that the /. rhosts file on the tapehost machine includes the 
hostname of the system you are updating. 

□ Ethernet controller type. 

Know the ethemet type and number of the system you are updating. 
Common ethemet number/types are ieO and leO. 

□ Sys category files 

For a remote installation with a tapehost running SunOS 4.0.2 or later, 
you must have Sys software category files installed on the tapehost. If 
the tapehost does not have the Sys category files installed, the upgrade 
win be significantly slower if using a 1/4 inch tape drive. 

If you do not have Sys files installed on the remotehost, do the following 
on the tapehost/server before beginning the upgrade: 

-—-N 

astro% inkdlr /usr/shar«/8ys 

astro% inkdix /usr/shar«/sys/con£.coinnon 

astro% od /uar/ahaxa/sya/conf.common 

astro% strings /vmunix | grep Ralaasa | awk '{print $3)' > BELEASE 

___ > 


There are two methods for adding additional sofware after you have completed 
an upgrade or installation: 

1. Use setup_exec in conjunction with the SunOS 4.0.3 Beta full installa¬ 
tion tapes selecting the desired software. 

2. Use setup_exec in conjuction with the SunOS 4.0 Rev. A full installa¬ 
tion tapes selecting the desired software. Then re-run sunupgrade using 
the OS 4.0.3 Upgrade tape. 


^sun 
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9.6. Upgrade Summary This is a summary of the necessary steps for upgrading your system. For specific 

configuration examples, see the following section. Upgrade Walkthrough Exam¬ 
ples 

1. Become super-user and back up aU filesystems. 

2. Verify the available disk space. Approximately 2-3 Mb free disk space is 
required for each disk partition that is updated. See the Planning Disk Space 
section in this chapter for more information on these requirements. 

3. Halt the system. 

4. Copy the miniroot. 

5. Run sunupgrade. 

sunupgrade interactively prompts you for the following information: 

□ Tape controller type 

□ Local or remote installation 

□ The disk device of the root partition 

□ Changed directory names of client partitions, if you are upgrading a 
server 

6. OPTIONAL: Install a small pre-configured kernel. Seethe Post-installation 
Procedures chapter in this manual for more information. 

7. Boot the system in single-user mode. 

8. Mount all local filesystems. 

9. Reconcile customized files with their new default versions. 

10. If upgrading a server, examine the f stab file entries for client partitions. 

11. If you did not install a small pre-configured kernel, configure a custom ker¬ 
nel. 

12. Boot in multi-user mode. 


»sun 
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9.7. Upgrade Walkthrough 
Examples 

Introduction This section contains upgrade walkthrough instructions for the following system 

configurations: 

□ Local Upgrade: Standalone 

□ Local Upgrade: Heterogeneous Server 

□ Remote Upgrade: Dataless 

□ Remote Upgrade: Standalone 

Local Upgrade refers to an upgrade that utilizes a local tape drive. Remote 
Upgrade refers to an upgrade that uses a remote tape drive and disk device. 

Each walkthrough example has a list of Example Variables. The variables define 
the system configuration for the upgrade, and are listed at the beginning of the 
example. 

Following the example variables is a Before You Begin section that gives infor¬ 
mation important to the specific upgrade configuration. 


0 ^ 


You do not have to configure your system exactly as shown. These are simply 
examples to help you design your own system configurations. Read the example 
of your choice completely BEFORE you begin the upgrade procedures. 
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9.8. LocalUpgrade: 

Standalone 

Example Variables: The following variables are used in this walkthrough. If you are using this exam¬ 

ple as a guide to upgrade your own system, use the device names and partition 
names applicable for your system. 

□ architecture: sun3 

□ hostname: birdwatch 
o upgrade type: local 

□ system type: standalone 
o tape device: (1/4" scsi) st 

□ root disk partition: sdOa 

Before You Begin: During the upgrade, the old kernel (vmunix) is renamed and a new GENERIC 

kernel is installed in its place. For instance, the old kernel is renamed 
vmunix.pre4.0.3. 

You can use either a pre-configured small kernel or you create a new kernel that 
reflects your exact system configuration. Read the Post-installation Procedures 
chapter of Installing the SunOS 4.0.3 for more information on configuring a ker¬ 
nel. 


Installation Steps: 

Step 1: Backing Up All Become super-user and back up all filesystems. For more information, see the 

Filesystems System and Network Administration manual. 
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Step 2: Verifying Disk 
Requirements 


Verify that there is at least 2-3 Mb of free disk space for each disk partition. The 
actual amoimt depends on the software you have installed. This includes the 
/, /usr, /var, /export, /root and/exec partitions, as well as 
any client 

root, /usr and /export/share partitions. 

See the Planning Disk Space section at the beginning of this chapter for more 
information on determining your requirements. 


Use the following method to display the available space for each partition. 


birdwatch# df 


Filesystem 

Kbytes 

Used 

Avail 

Capacity 

Mounted On 

/dev/sdOa 

7608 

2700 

4147 

39% 

/ 

/dev/sdOg 

276550 

32709 

216136 

13% 

/usr 





In the case that you do not have sufficient disk space available to proceed with 
the upgrade, contact your system administrator. It is imperative that you have 
the available disk space before proceeding with the upgrade. 


Step 3: Halting the System After you have determined there is sufficient disk space, halt the system using the 

following method. 


/-^- 

birdwatch# /etc/halt 



J 


Step 4: Copying the Miniroot Mount the release tape, and copy the miniroot from tape to disk. For more infor¬ 
mation, see the Copying Miniroot section of Chapter 4 in this manual. 

Step 5: Starting the Upgrade Once the miniroot is u invoke sunupgrade using the following method. 

Answer the series of prompts shown in the following example. 
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# cd /u«r/etc/vipgrada 

# Bunupgrada 

Enter root disk partition for sun3 architecture: sdOa 
Wait .. 

Is this a file-server <as opposed to standalone / 
dataless-client>? (y/n): n 

Where is the tape drive located? (local I remote): toc^ 

Enter controller type < st | mt ( xt ) : 5/^ 

Extracting TOC (Table of Contents) 

0+1 records in 
0+1 records out 

Starting to upgrade now. Continue? (y/n): y 
This is going to take some time. 

Extracting "root" files 
Extracting "usr" files 


Installing bootblock to root partition /dev/rsdOa .. 

Installing /sbin files .. 

Doing file system checks 

sunupgrade: Done installing upgrade 4.0.3 

V_ ) 

Once sunupgrade is completed, it summarizes the steps required to finish the 
upgrade. 
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-^ . 

NEXT STEPS 


* OPTIONAL: Install a smaller generic kernel 
install_sinall_kernel 

* Reboot and come up single-user 

* Check and install special_files 
(look in /usr/etc/upgrade/save) 

* Reconfigure your kernel^ and if successful 

* Come up in multi-user mode 

V_/ 


You have the option of installing a pre-configured kernel after sunupgrade is 
yc— completed and before you reboot, if the system you are upgrading is a diskless 

i ^ client, or has a SCSI device. The small kernel is only configured for SCSI dev¬ 

ices. 

See the Post-installation Procedures chapter of this manual for more information 
on installing a small kernel. 

Step 6: Rebooting the System Halt and reboot the system coming up single-user. Use the following method. 




UiizaJ 


>b vmunix -s 


., messages .. 


# csh 


# setenv TERM sun 

V_ 

J 




The csh command puts you into the C shell. Setting the TERM variable allows 
you to use vi in visual mode when reconciling the user-customized files. 


Step 7; Mounting Local 
Filesystems 


Mount all local filesystems using the following method: 

. ....... . ... . 

birdwatch# mount -at 4.2 
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Step 8: Checking Special Files Check special files using the following method. 

birdwa1:ch# cd /usr/etc/upgrade/sava 
birdwatch# Is 
RELEASE special_filea 
birdwatch# cat spacial^filas 

Release 4.0.3 

Processing started for server on Tues Jan 10 12:10:44 PST 1989 
Special files ~ will be installed with the ”4.0.3" as suffix 

/etc/format.dat 
/etc/rc.local 

birdwatch# cd /ate 
birdwatch# Is -'I *4.0.3 
format. dat-‘4.0.3 
rc;local-4.0.3 

birdwatch# diff rc.local rc.local-4•0,3 
.. differences .. 

. -j 



The special_f lies listed will vary from system to system in accordance 
with the software installed. 


Step 9: Customizing and 
Installing Special Files 


Customize the special files, and then install them using the following method. 

-^^ 

birdwatch# mv rc.local rc.local.old 

birdwatch# mv rc.local-4.0.3 rc.local 
birdwatch# vi rc.local 

<custoinize rc . local on the basis of rc . local. old> 

birdwatch# mv format.dat format.dat.old 
birdwatch# mv format.dat-4.0.3 format.dat 


<customize files as necessary> 



Step 10: Configuring a Custom If you did not install a small kernel after step 5, it is recommended that you 
Kernel configure a custom kernel. For information on configuring a custom kernel, see 

the Post-installation Procedures Qiapter of this manual. 



Revision A, of 25 Ajjril 1989 




Chapter 9 — Performing a System Upgrade 183 


Step 11: Booting in Multi-User Halt the system and boot in multi-user mode using the following method. 
Mode 
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9.9. Local Upgrade: 

Heterogeneous 

Server 

Example Variables: The following variables are used in this walkthrough. If you are using this exam¬ 

ple as a guide to upgrade your own system, use the device names and partition 
names applicable for your system. 

□ server architecture: sun4 

□ hostname: boomer 

□ sun3 client name: toots 

□ sun4 client name: whoopie 

□ upgrade type: local 

□ system type: heterogeneous server 

□ tape device: (1/2") xt 

o root disk partition: xyOa 

Before You Begin: The old kernel (vmunix) is renamed and a new GENERIC kernel is installed in 

its place. For instance, the old kernel is renamed vmunix. pre4,0.3 if 
SunOS 4.0.3 is the current upgrade revision. 

You will have to configure the new kernel for customization. Read the Post¬ 
installation Procedures chapter of Installing the SunOS 4.0.3 for more informa¬ 
tion on configuring a kernel. 

For Server Configurations: 

Once you have started sunupgrade you must select 1. Upgrade all 
from the sunupgrade menu at the beginning of a server upgrade. The 
remaini n g options are available if the upgrade is halted during execution. You 
can then re-start sunupgrade and continue the upgrade from the place where it 
halted by choosing the appropriate option: 2,3,4, or 5. 

sunupgrade makes the assumptions that all clients’ root directories cdan be 
reached from one directory pathname, as can aU client /usr directories. For 
instance, your client root partitions may be renamed /f oobar instead of 
/export/root, and your client usr partitions maybe renamed /maddog 
instead of /export/exec. 
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Users who have not followed Sun conventions in this regard must create sym¬ 
bolic links to link together all client and client /usr directories. 

For information on creating symbolic links for client files not in one directory, 
see the Work Around: Client Files Not in One Directory section at the beginning 
of this chapter. 

On a heterogeneous server, Sun-2 clients now mount /export/share onto 
their /usr/share partitions, instead of /export/share. sunos4.0. 

In SunOS 4.0.3, /export/exec/sun2 is a directory instead of a symbolic 
link to directory /export /exec/sun2 . sunos4.0. 

NOTE: If you have a heterogeneous server without any diskless clients, 
sunupgrade only updates the /usr partition files for the server architecture 
type. 


Installation Steps: 

Step 1: Halting All Clients 


Step 2: Backing Up All 
Filesystems 

Step 3: Verifying Disk 
Requirements 


Halt all clients. For more information, see the System and Network Administra¬ 
tion manual. 

Become super-user and back up aU filesystems. For more information, see the 
System and Network Administration manual. 

Verify that there is at least 2-3 Mb of free disk space for each disk partition. The 
actual amount depends on the software you have installed. This includes the /, 
/usr, /var, /export, /root and / exec partitions, as well as any client 
root, /usr and /export/share partitions. 

See the Planning Disk Space section at the beginning of this chapter for more 
information on determining your requirements. 


wsun 

XT microsystems 
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Use the following method to display the available space for each partition. 


boomer# df 



Filesystem 

Kbytes 

Used 

/dev/xyOa 

7511 

4032 

/dev/xyOg 

69540 

58586 

/dev/xyOe 

55616 

15649 

/dev/xyOd 

18325 

6032 

/dev/xylg 

260874 

9 

/dev/xyOh 

76303 

9898 


Avail 

Capacity 

Mounted On 

2727 

60% 

/ 

4000 

94% 

/usr 

34405 

31% 

/expo rt/swap 

10460 

37% 

/export/root 

234777 

0% 

/spareO 

58774 

14% 

/home 



In the case that you do not have sufficient disk space available to proceed with 
the upgrade, contact your system administrator. It is imperative that you have 
the available disk space before proceeding with the upgrade. 


Step 4: Halting the System After you have determined there is sufficient disk space, halt the system using the 

following method. 

f -\ 

boomer# /etc/halt 

V_^^ 


Step 5: Copying the Miniroot Mount the release tape, and copy the miniroot from tape to disk. For more infor¬ 
mation, see the Copying Miniroot section of Chapter 4 in this manual. 

Step 6: Starting the Upgrade Once the miniroot is up, invoke sunupgrade using the following method. 

Answer the series of prompts shown in the following example. 
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— 

# cd /utr/atc/u|>grada 

# sunupgrado 

Enter root disk partition for sun4 architecture: xyOa 

Wait 

Is this a file-server (as opposed to standalone / 

dataless-client)? (y/n): y 

WARNINGI If you are not sure of any of the answers to the 
questions below, exit the miniroot, come up in multi-user 
mode, obtain necessary information and restart the whole 
process. Refer to the Read This First documentation for 
details. 

The following assumptions are being made for this upgrade: 

1. You have not changed your file system from the Sun standard 

2. If sunupgrade finds that this is a server without any client 
root partitions (Ex: A server serving dataless clients only), 
it will upgrade only the client usr areas. If yours is such 

a case, it does not matter what you answer in response to the 
query on client root partition name. 

3. If this is a server, the client partitions are assumed to 
be as follows: 

All client usr file partitions are under: /export/exec 
All client root file partitions are under: /export/root 
All client swap file partitions are under: /export/swap 
V_ 


Hit [ Return I to continue. 

- ^ 

4. All client usr partitions MUST be in one directory. Similarly 
for client root partitions (if they exist). 

If you have client usr (or root) partitions scattered in more 
than one location, exit now and do the following: 

Select one of the directories containing the most number 
of exec directories as your primary exec directory, and 
one of the client root directories as your primary client 
root directory. Set up symbolic links bearing the same names 
(with relative pathnames) in your primary directory to the 
entries wherever they may be and restart sunupgrade* When 
you come to this menu, enter the primary directory names 
at the prompt♦ 


Refer Installation Instructions for details. 



Continued in the following: 
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( N 

Continue (y/n/q) ; y 

Change clients usr file partitions from /export/exec (y/n): n 
Change clients root file partitions from /export/root (y/n): n 
Change clients swap file partitions from /export/swap (y/n )x n 
Where is the tape drive located? (local | remote) : local 
Enter controller type ( st 1 mt | xt ) : xf 

1. Upgrade all 

2. Upgrade Server only 

3. Upgrade all clients 

4. Upgrade clients of same architecture only 

5. Upgrade clients of other architecture only 

Select one of the above♦ The default is 1» Enter choice: 1 

V._ ) 



You should select 1. Upgrade all from the sunupgrade menu at the 
beginning of a server upgrade, sunupgrade will first upgrade the server’s exe¬ 
cutables then cycle through the clients updating each in turn. This may take a 
while. 


The remaining options are available if the upgrade is halted during execution. 
You can then re-start sunupgrade and continue the upgrade from the place 
where it halted by choosing the appropriate option: 2,3,4, or 5. 


f -\ 

Extracting TOC (Table Of Contents) 

0+1 records in 
0+1 records out 

Starting upgrade now. Continue ? (y/n): y 
This is going to take some time^ 

Extracting "root” files 
Extracting "usr" files 


V_:_; 
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Continued in the following: 

upgrading sun3 clients 
Upgrading sun3 client toots 
Extracting "root” files 
Upgrading sun4 clients 
Insert tape for sun4 
Continue (y/n/q) : y 

Extracting **usr" files 


Upgrading sun4 clients 
Upgrading sun4 client whoopie 
Extracting "root" files 

Installing bootblock to root partition /dev/rxyOa .. 
Installing /sbin files .. 

Doing file system checks 

sunupgrade: Done installing upgrade 4,0.3 
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Once sunupgrade is completed, it summarizes the steps required to finish the 
upgrade. 

- 

NEXT STEPS 


* OPTIONAL: Install a smaller generic kernel using 
i n s t a 1 l_sxtia 1 l_ke rn e 1 

* Reboot and come up single-user 

* Check and install special_files 
(look in /usr/etc/upgrade/save) 

* Reconfigure your kernel^ and if successful 

* Come up in multi-user mode 

V- ) 



You have the option of installing a pre-configured kernel after sunupgrade is 
completed. The small pre-configured kernel supports common configurations 
with up to two SCSI devices. It also supports dataless configurations. The small 
kernel is only configured for SCSI devices. 

See the Post-installation Procedures chapter of this manual for more information 
on installing a small kernel. 


Step 7; Rebooting the System 


Halt and reboot the system coming up single-user. Use the following method. 




1 Ll-a 1 


>b vmunix -s 


.. messages .. 


# csh 


# setenv TERM sun 

s_ 

j 



The csh command puts you into the C shell. Setting the TERM variable allows 
you to use vi in visual mode when reconciling the user-customized files. 


Step 8: Mounting Local 
Filesystems 


Mount all local filesystems using the following method: 

-- . 

boomer# mount -at 4*2 

V _^ 
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Step 9: Checking Special Files Check special files using the following method. 

boomer# cd /usr/etc/upgrade/save 

boomer# Is 

RELEASE toots •upgrade^f lies toots. sped al__files 

npgrade^files whoopie,upgrade_^files whoopie.spedal^files 
spedal^files 
boomer# cat speclal__£±les 

Release 4.0.3 

Processing started for server on Tues Jan 10 12:15:12 PST 1989 
Special files -- will be installed with the "4.0,3" as suffix 

/etc/format.dat 
/etc/rc.local 

boomer# cd /etc 
boomer# Is *4.0.3 
format. dat-4.0.3 
rc^local-4.0*3 

boomer# dif£ rc«local rc.local-4. 0 .3 
,. differences ,. 

^; _ > 



The special_f lies listed will vary from system to system in accordance 
with the software installed. 


Step 10: Re-Customizing Local Edit the files affected by the upgrade, and then rename them using the following 
Files method. 


-^ 

boomer# mv rc.local rc,local.old 

boomer# mv rc.local-4.0.3 rc.local 
boomer# vl rc.local 

<customize rc.local on the basis on rc.local.old> 

boomer# mv format.dat format.dat.old 
boomer# mv format .dat-4.0.3 foarmat.dat 

<Similarly inspect clientname.special__files for all clients.> 
<Then cd to /export/root/clientname/etc and do the same. > 
<Repeat for all clients. > 


Step 11: Examining Clientfstab Examine the /etc/f stab entries for client partitions to make sure they are 

Entries mounted. Mount entries as necessary. 
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Step 12: Configuring a Custom If you did not install a small kernel after step 6, it is recommended that you 
Kernel configure a custom kernel. For information on how to configure your kernel, see 

the Post-installation Procedures Chapter of this manual. 

Step 13: Booting in Multi-User Halt the system and boot in multi-user mode using the following method. 

Mode 
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9.10. Remote Upgrade: 

Dataless 

Example Variables: The following variables are used in this walkthrough. If you are using this exam¬ 

ple as a guide to upgrade your own system, use the device names and partition 
names applicable for your system. 

□ architecture: sun3 

o hostname: groucho 

a server name: zeppo 

□ server internet address: 192.9.101.29 

□ tapehost name: gummo 

□ tapehost internet address: 192.9.101.44 

□ ethemet type: ieO 

□ upgrade type: remote 

□ system type: dataless 

□ tape device: (1/4" scsi) st 

□ root disk partition: sdOa 

Before You Begin: During the upgrade, the old kernel (vmunix) is renamed and a new GENERIC 

kernel is installed in its place. For instance, the old kernel is renamed 
vmunix.pre4.0.3. 

You can use either a pre-configured small kernel or you create a new kernel that 
reflects your exact system configuration. Read the Post-installation Procedures 
chapter of Installing the SunOS 4.0.3 for more information on configuring a ker¬ 
nel. 

For Dataless Clients: 

When upgrading dataless clients be aware of the following items: 

□ All usr partition files (files under /usr) are assumed to be resident on the 
server and mounted from the server on the client over NFS. All other root 
partition files are assumed to be local to the dataless client. 
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Installation Steps: 

Step 1: Backing Up All 
Filesystems 


□ You should include the server name and internet number in the 

/etc/hosts file of the machine you are updating. If this information is 
not included in the /etc/hosts file before starting the upgrade, you will 
be prompted for the information during the upgrade procedure. 

□ The hostname of the system you are updating must be included in the 
/ . rhosts file of the server. 

□ The server must have the Sys software category files installed on it or 
sunupgrade will not let you upgrade the client. 

For Remote Installations: 

When performing an installation over the network from a remote tape drive, note 
the following items; 

o Tapehost Hostname 

Know the hostname of the machine with the tape drive (the tapehost). 

□ /etc/hosts 

Ensure that the /etc/hosts file of the machine that you are updat¬ 
ing includes the internet number and hosmame of the tapehost. 

□ /.rhosts 

Ensure that the /. rhosts file on the tapehost machine includes the 
hostname of the system you are updating. 

□ ethemet controller type. 

Know the ethemet type and number of the system you are updating. 
Common ethemet number/types are ieO and leO. 

□ Sys category files 

For a remote installation with a tapehost running SunOS 4.0.2 or later, 
you must have Sys software category files installed on the tapehost. If 
the tapehost does not have the Sys category files installed, the upgrade 
will be significantly slower if using a 1/4 inch tape drive. 

If you do not have Sys files installed on the remotehost, do the following 
on the tapehost/server I. before beginning the upgrade: 

- 

g\insno% B^dir /us r/share/sys 

gummo% mkdir /usr/share/sys/con£. common 

guinmo% cd /usr/share/sys/con£.common 

gummo% strings /vmunix | grep Release | awk '{print $3)' > RELEASE 

v._/ 


Become super-user and back up aU filesystems. For more information, see the 
System and Network Administration manual. 



microsystems 
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Step 2: Verifying Disk 
Requirements 


Verify that there is at least Verify that there is at least 2-3 Mb of free disk space 
for each disk partition. The actual amount depends on the software you have 
installed. This includes the 

/, /usr, /var, /export, /root and/exec partitions, as weU as 
any client 

root, /usr and/export/share partitions. Planning Disk Space section 
at the beginning of this chapter for more information on determining your 
requirements. 


Use the following method to display the available space for each partition. 

-^ 

groucho# df 


Filesystem 

Kbytes 

Used 

Avail 

Capacity 

Mourited On 

/dev/sdOa 

7608 

2700 

4147 

39% 

/ 

/dev/sdOg 

276550 

32709 

216186 

13% 

/home 




In the case that you do not have sufficient disk space available to proceed with 
the upgrade, contact your system administrator. It is imperative that you have 
sufficient disk space before proceeding with the upgrade. 


Step 3: Halting the System After you have determined there is sufficient disk space, halt the system using the 

following method. 

- - 

groucho# /etc/halt 

.. 


Step 4: Copying the Miniroot 


Step 5: Starting the Upgrade 


Mount the release tape, and copy the miniroot from tape to disk. For information 
on copying the miniroot from a remote tape drive, see the Remote Installation: 
Standalone example in Chapter 6 of this manual. 

Once the miniroot is running, invoke sunupgrade using the following method. 
Answer the series of prompts shown in the following example. 


microsystems 
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Once sunupgrade is completed, it summarizes the steps required to finish the 
upgrade. 

- —-> 

NEXT STEPS 


* OPTIONAL; Install a smallar generic kernel using 
i n s tal l_siiia 1 l_ke rne 1 

* Reboot and come up single-user 

* Check and install speoial_files 
(look in /usr/etc/upgrade/save) 

* Reconfigure your kernel, and if successful 

* Come up in multi-user mode 

_ J 



You have the option of installing a pre-configured kernel after sunupgrade is 
completed. The small pre-configured kernel supports common configurations 
with up to two SCSI devices. It also supports dataless configurations. The small 
kernel is only configured for SCSI devices. 

See the Post-installation Procedures chapter of this manual for more information 
on installing a small kernel. 


Step 6: Rebooting the System Halt and reboot the system coming up single-user. Use the following method. 


f 

\ 

\ . 


>b vmunix -s 


* ^ messages .. 


# C3h 


# 3et:env TERM 3un 

.j 



The csh command puts you into the C shell. Setting the TERM variable allows 
you to use vi in visual mode when reconciling the user-customized files. 


Step 7: Mounting Local 
Filesystems 


Mount all local filesystems using the following method: 


f 

# mount -at 4.2 


V_ 
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Step 8: Reconciling User Use the following method to reconcile previously customized files with their new 

Customized Files installed revisions. The names of files requiring reconciliation are written into 

the file /usr/etc/upgrade/save/special_f lies by sunupgrade. 


^ 

groucho# cd /homo/upgrada 
groiacho# la 
RELEASE $pecial_files 
groucho# cah special^filaa 

Release 4.0.3 

Processing started for standalone on Tues Jan 10 15:15:10 PST 1989 
Special files - will be installed with the ”4.0.3” as suffix 

/etc/format.dat 
/etc/rc.local 

groucho# cd /etc 
groucho# la -1 *4^0.3 
format.dat-4.0.3 
rc»local-4.0^3 

groucho# diff rc.local rc.local-4.0.3 
.. differences -. 

V_:_> 



The user customized files needing reconciliation will vary somewhat from sys¬ 
tem to system in accordance with the software installed. 


Step 9: Re-Customizing Local 
Files 


Edit the files affected by the upgrade, and then rename them using the following 
method. 

- 

groucho# mv rc.local rc.local.old 
groucho# mv rc.local-4.0.3 rc.local 
groucho# vi rc.local 

<customize rc.local on the basis of rc.local.old> 

groucho# xnv forxnat.dat format .dat .old 
groucho# mv format .dat-4.0.3 forxnat.dat 

<custoinize files as necessarY> 

V_> 


Step 10: Configuring a Custom If you did not install a small kernel after step 5, it is recommended that you 
Kernel configure a custom kernel. For information on configuring a custom kernel, see 

the Post-installation Procedures Chapter of this manual. 
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Step 10: Booting in Multi-User 
Mode 


Halt the system and boot in multi-user mode using the following method. 

-\ 

groucho# /etc/halt 
>b 

_ ^ 
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9.11. Remote Upgrade: 

Standalone 

Example Variables: The following variables are used in this walkthrough. If you are using this exam¬ 

ple as a guide to upgrade your own system, use the device names and partition 
names applicable for your system. 

□ architecture: sun3 
o hostname: yahoo 

□ tapehost name: whammo 

□ tapehost internet address: 192.9.101.44 

□ ethemet type: ieO 

□ upgrade type: remote 

□ system type: standalone 

□ tape device: (1/4" scsi) st 

□ root disk partition: sdOa 

Before You Begin: During the upgrade, the old kernel (vmunix) is renamed and a new GENERIC 

kernel is installed in its place. For instance, the old kernel is renamed 
vmunix.pre4.0.3. 

You can use either a pre-configured small kernel or you can create a new kernel 
that reflects your exact system configuration. 

Read the Post-installation Procedures chapter of Installing the SunOS 4.0.3 for 
more information on configuring a kernel. 

For Remote Installations: 

When performing an installation over the network from a remote tape drive, note 
the following items: 

□ Tapehost Hostname 

Know the hostname of the machine with the tape drive (the tapehost). 

□ /etc/hosts 

Ensure that the /etc/hosts file of the machine that you are updat¬ 
ing includes the internet number and hosmame of the tapehost. 
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Installation Steps: 

Step 1: Backing Up All 
Filesystems 

Step 2: Verifying Disk 
Requirements 


□ /.rhosts 

Ensure that the /. rhosts file on the tapehost machine includes the 
hostname of the system you are updating. 

□ ethemet controller type. 

Know the ethemet type and number of the system you are updating. 
Common ethemet number/types are ieO and leO. 

□ Sys category files 

When doing a remote installation with a tapehost miming SimOS 4.0.2 
or later, the Sys software category files must be installed on the 
tapehost. If not, an upgrade using a 1/4" tape drive will be significantly 
slower. 


If you do not have the Sys category files installed on the tapehost, do the 
following on the tapehost before you begin the upgrade: 


whainmo% mkdlx /u*r/*har«/»ya 

whammo% mkdlr /usr/ahar«/ays/conf.comnon 

whainmo% cd /uat/ahar«/aya/oon£.ooimnon 

whainmo% atringa /vmunix | gx«p Relaaa* { awk ' (prixi't $3)' > BE! 


Become super-user and back up aU filesystems. For more information, see the 
System and Network Administration manual. 

Verify that there is at least Verify that there is at least 2-3 Mb of free disk space 
for each disk partition. The actual amount depends on the software you have 
installed. This includes the 

/, /usr, /var, /export, /root and/exec partitions, as well as 
any client 

root, /usr and /export/share partitions. 

Planning Disk Space section at the begiiming of this chapter for more informa¬ 
tion on determining your requirements. 

Use the following method to display the available space for each partition. 

yahoo# df 


Filesystem 

Kbytes 

Used 

Avail 

Capacity 

Mounted On 

/dev/sdOa 

7608 

2700 

4147 

39% 

/ 

/dev/sdOg 

276550 

32709 

216186 

13% 

/usr 



sun 
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In the case that you do not have sufficient disk space available to proceed with 
the upgrade, contact your system administrator. It is imperative that you have 
the available disk space before proceeding with the upgrade. 


Step 3: Halting the System After you have determined there is sufficient disk space, halt the system using the 

following method. 

' 

yahoo# /etc/halt 

V_ 


Step 4: Copying the Miniroot Motint the release tape, and copy the miniroot from tape to disk. For information 

on how to copy the miniroot from a remote tape drive, see the Remote Installa¬ 
tion: Standalone example in Qiapter 6 of this manual. 


Step 5: Starting the Upgrade 


Once the miniroot is up, invoke sunupgrade using the following method. 
Answer the series of prompts shown in the following example. 
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- 

# cd /usr/«tc/upgrad0 

# sunupgrada 

Enter root disk partition for sun3 architecture: sdOa 
Wait •. 

Is this a file*-server (as opposed to standalone / 
dataless^client)? (y/n): n 

Where is the tape drive located? (local | remote) ; remote 
Enter host name of the remote tape drive; whammo 
Enter ethernet type of this system [ec 1 ie | le] ; /e 
Using ieO or iel ? [ 0 | 1] : 0 
Ethernet connects to ieO 

Enter remote host'^s internet number (Ex: 192.9.101.22): 192.9A0U4 

Extracting TOC (Table Of Contents) 

0+1 records in 
0+1 records out 

Starting upgrade now. Continue ? (y/n): y 
This is going to take some time. 

Extracting "root” files 


Installing bootblock to root partition /dev/rsdOa .* 

Installing /sbin files .» 

Doing file system checks 

sunupgrade: Done installing upgrade 4.0.3 

___ .j 
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Once sunupgrade is completed, it summarizes the steps required to finish the 
upgrade. 

-^ 

NEXT STEPS 


* OPTIONAL: Install a smaller generic kernel using 
i n s t a 1 l___sma 1 l_kerne 1 

* Reboot and come up single-user 

* Check and install special_file 
<look in /usr/etc/upgrade/save) 

* Reconfigure your kernel, and if successful 

* Come up in multi-user mode 

s,_^ 



You have the option of installing a pre-configured kernel after sunupgrade is 
completed. The small pre-configured kernel supports common configurations 
with up to two SCSI devices. It also supports dataless configurations. The small 
kernel is only configured for SCSI devices. 

See the Post-installation Procedures chapter of this manual for more information 
on installing a small kernel. 


Step 6: Rebooting the System 


Halt and reboot the system coming up single-user. Use the following method. 




The csh command puts you into the C sheU. Setting the term variable allows 
you to use vi in visual mode when reconciling the user-customized files. 


Step 7: Mounting Local 
Filesystems 


Mount all local filesystems using the following method: 


r 


# mount -at 4*2 


V. 

_/ 
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Step 8.-Reconciling User Use the following method to reconcile previously customized files with their new 

Customized Files installed revisions. The names of files requiring reconciliation are written into 

the file /usr/etc/upgrade/save/special_f lies by sunupgrade. 


r . 

yahoo# cd /usr/etc/upgrade/save 
yahoo# la 

RELEASE 5peciaJ._file3 
yahoo# cat apacial^^filea 

. . I.MM ... 1 

Release 4.0.3 

Processing started for standalone 
Special files - will be installed 

on Wed Jan 11 14:12:15 PST 1989 

with the ”4.0.3** as suffix 

/etc/format.dat 
/etc/rc.local 


yahoo# cd /ate 
yahoo# la -1 *4.0.3 
format.dat-4.0.3 

rc. local “'4.0.3 

yahoo# di££ rc.local rc.local-4.0. 

.. differences . . 

.3 

_ 




The user customized files needing reconciliation will vary somewhat from sys¬ 
tem to system in accordance with the software installed. 


Step 9: Re-Customizing Local 
Files 


Edit the files affected by the upgrade, and then rename them using the following 
method. 

-N 

yahoo# mv rc.local rc.local.old 
yahoo# xnv rc.local-4.0.3 rc.local 
yahoo# vi rc.local 

<customize rc.local on the basis of rc.local.old> 

yahoo# mv format.dat format.dat.old 
yahoo# mv format.dat-4.0.3 format.dat 


<customize files as necessary> 



Step 10: Configuring a Custom If you did not install a small kernel after step 5, it is recommended that you 
Kernel configure a custom kernel. For information on configuring a custom kernel, see 

the Post-installation Procedures chapter of this manual. 
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Step 11: Booting in Multi-User 
Mode 


Halt the system and boot in multi-user mode using the following method. 

f N 

yahoo# /etc/halt 
>b 

V_y 
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This chapter is a reference section and is made up of the following sections: 
□ Manual Pages 
o Glossary 

The following manual pages are included in this section: 
suninstall 

setup_client(8) 

setup_exec 

sunupgrade 

sunupgrade(8) 





SETUP_CLffiNT(8) 


MAEsTTENANCE COMMANDS 


SETUP_.CLffiNT(8) 


NAME 

setup_client - create or remove an NFS client 
SYNOPSIS 

/usr/etc/mstal]/script/setup_client op clientname ypjype swapsize rootpath swappath homepath execpath 
kvmpath arch 

DESCMPTION 

setup_client adds an NFS client to a server, or removes one. It can only be run by the super-user. It is also 
used by sunmstall(8). 

The op argument indicates which operation to perform; it can be either add or remove, to indicate whether 
to add or remove a client, clientname is the hostname of the client ypjype indicates the type of Yellow 
Pages server or service to provide to the client, if any; it can be one of master, slave, client or none. 
swapsize is the number of bytes reserved for client’s swap file, rootpath is the pathname of parent direc¬ 
tory in which various client root directories reside; rootpath!clientname is the pathname of the client’s root 
directory, swappath is the pathname of parent directory in which various client swap files reside; 
swappath!clientname is the pathname of the client’s swap file, homepath is the pathname of the (parent) 
directory in which the various home directories are to reside; it is the pathname of the directory that the 
client is to mount as /home, execpath is the full pathname of the directory in which the executables for the 
architecture specified by the arch argument. This is the directory that the client mounts as /usr. kvmpath is 
the full pathname of the directory in which the sun-architecture executables reside for the architecture 
specified by the architecture argument. This is the directory that the client mounts as /usr/kvm. arch 
specifies the client’s architecture (for instance, sun4, sun3...). setup_client with no arguments displays a 
usage message that includes the proper arch argument for each supported architecture. 

USAGE 

Before you add or remove a client, you must first make sure that the Internet and Ethernet addresses for 
clientname are listed in the YP hosts database (if the server is running the YP), or in the server’s /etc/hosts 
and /etc/ethers databases, respectively (otherwise). Then, run setup_client with the add or remove opera¬ 
tion. When adding a client, you must then bootstrap that client machine. 

You cannot add a client to a server that does not support the specified architecture. The executable direc¬ 
tory fcHT that client’s architecture must be present on the server. If this file is absent, an error results. 

setup_client updates the /etc/bootparams file. If the server is a YP master, it updates local YP database. It 
does not propagate the local update to other YP servers. To propagate the updates, use the following com¬ 
mands: 

example# cd /var/yp 
example# make 

If the server is running YP but is not a YP master, setup_client issues a warning to indicate that the data¬ 
base is out of date. 

When arch is given as sun2, suninstall issues a reminder to run the /usr/etc/ndbootd daemon for booting 
Sun-2 systems. 

setup_client creates swappath!clientname with the size^ (number of bytes) you specify. You can append 
one of K or k to indicate kilobytes, M or m to indicate megabytes, or B or b to indicate 512-byte blocks, to 
size. Otherwise, size is taken to indicate an exact byte count. 

suninstall updates the /etc/export file to allow root access to each client’s root file system. It exports the 
client’s swap and dump partitions only to the client. Note: the system administrator should verify that the 
/etc/exports file contains correct information, and that file systems are exported to the correct users and 
groups. Refer to exportfs(8) for details on exporting file systems. 
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SETUP_CLffiNT(8) 


MAINTENANCE COMMANDS 


SETUP_CLIENT(8) 


EXAMPLES 

This example shows how to add a Sun-4 system NFS client to a server. 

example# setupclient add frodo client 16M /export/root /export/swap /home \ 
/export/exec/kvm/sun4 sun4 

To remove this client, you would merely substitute remove for add in the above example. 

FILES 

/etc/hosts 

/etc/ethers 

/usr/etc/ndbootd 

/etc/bootparams 

/etc/exports 

SEE ALSO 

exportfs(8), setup_exec(8) sunmstall(8) 

Installing the SunOS 
DIAGNOSTICS 

incorrect number of arguments 

Check number and order of the arguments. 

must be run as root (super-user). 

You must be root to use setup_client. 

invalid operation type “xx”. 

Valid operations are add and remove. 

ATTENTION: xxxxxxxx -> boot.sun.^ not created. 

(Sun-3 systems only.) A symbolic link can not be created because the boot file does not exist. 

ATTENTION: xxxaxcc.SUN.^ -> boot.sun.^ not created. 

(Other than Sun-3 systems.) A symbolic link can not be created because the boot file does not 
exist. 

ATTENTION: /usr/etc/ndbootd needs to be running on server before bringing up ^^clienf\ 

The Sun-2 system boot daemon must be running in order to bootstrap a Sun-2 system. 
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SETUP_EXEC(8) 


MAINTENANCE COMMANDS 


SETUP_EXEC(8) 


NAME 

setup_exec - install architecture-dependent executables on a heterogeneous file server 
SYNOPSIS 

/usr/etc/mstall/setup_exec arch execpath kvmpath 
DESCRIPTION 

setup_exec installs architecture-dependent executables from either a local tape drive or a remote host. It is 
used to convert a standalone system or homogeneous file server to a heterogeneous file server. setup_exec 
is a forms-based utility that can be invoked directly, but it is also used by suninstall(8). It can only be 
invoked by the super-user. 

The arch argument specifies the machine archictecture to install (for instance, sun4, sun3...). When run 
with no arguments, setup_exec displays a usage line that includes the proper format of the arch argument 
for each supported architecture, execpath is the full pathname of the directory in which to install the exe¬ 
cutables. kvmpath is the full pathname of the directory in which to install the sub-architecture dependent 
executables. When setup_exec is done, the execpath and kvmpath directories are ready to mount as /usr 
and /usr/kvm by the server’s NFS clients of the indicated arch, 

setup__exec also updates the /etc/export file (see exportfs(8)) to export the executable directories it has 
installed. The system administrator should verify this file to make sure that the directory has been exported 
to the correct groups. 

EXAMPLE 

This example shows how to install a directory of executables for Sun-4 system clients, 
example# setup_exec sun4 /export/exec/kvm/sun4 

FILES 

/etc/hosts 
/etc/ethers 
/etc/export 

/usr/etc/mstall/files/extractlist.arcA 

SEE ALSO 

exportfs(8), setup_client(8), suninstall(8) 

Installing the SunOS 

DIAGNOSTICS 

incorrect number of arguments 

Check the number and the order of arguments. 

invalid architecture type 

You supplied a value for arch that is not supported. 

invalid tape drive type ^^drive^\ 

Valid tape drive types are local and remote. 

invalid tape type ‘Uape^\ 

Valid tape types are ar, st, mt, and xt. 

can’t reach tapehost ^Uapehost'\ 

The IP address of tapehost is not in the hosts database, that is, the hosts YP database if the Yellow 
Pages are running, or the /etc/hosts file otherwise. 

Load release tape n 

Mount the release tape specified on the screen and type RETURN to continue. 


hosts database 

database of hosmames and Ethernet addresses 
database of exported file systems 

record of extracted categories for the indicated architecture 
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SUNUPGRADE(8) 


MAINTENANCE COMMANDS 


SUNUPGRADE(8) 


NAME 

sunupgrade - upgrade the Sun Operating System 
SYNOPSIS 

/usr/etc/sunupgrade [ -1 ] [ -d ] [ -n ] 

AVAILABILITY 

This command is available on sun2, sun3 and sun4 architectures running SunOS version 4.0 only. Refer to 
Installing the SunOS 4.0.3 for more information. 

DESCRIPTION 

sunupgrade is an interactive utility that is used to upgrade the Sun Operating System (SunOS) to a higher 
revision level on sun2, sun3, and sun4 architectures. The current SunOS level must be at least SunOS 4.0. 

sunupgrade lets you upgrade any system configuration. The following are the valid configuration types: 

• Standalone 

• Homogeneous server 

• Heterogeneous server 

• Dataless clients 

• Diskless clients 

Both local and remote installation modes are supported. 

sunupgrade overlays the newer executable files on top of existing ones. For files in and if the new file 
names and old file names conflict and the files are not identical in content, then the new file is installed with 
a trailing suffix that is the release name. The differences between the old and the new versions of the files 
must be resolved by the user. All such files are logged in the log file /usr/etc/upgrade/save/special_files 
for servers, standalone systems, or in /usr/etc/upgrade/save/c//^nrwaAn^^pecial_files for diskless clients. 
For dataless clients, they are shared under /home/upgrade/special_files. 

After sunupgrade completes execution you must come up in single-user mode, inspect all special files and 
propogate your older administrative files to the newer ones and rename them without the suffixes. 

OPTIONS 

-1 Create log of all files extracted and overlaid. Performance will deteriorate slightly. Log files are 
saved in /usr/etc/upgrade/save. Special files are called 

-d Work in debugging mode. Not recommended for normal operation. 

-n Switch off ”no-rewind” operation. The no-rewind operation available only on systems running 
SunOS 4.0.2 or 4.0.3. 

FILES 

/usr/etc/upgrade/EXCLUDELIST 

/usr/etc/upgrade/README 

/usr/etc/upgrade/checksums 

/usr/etc/upgrade/chk_ok 

/ usr/e tc/upgrade/chk_release 

/usr/etc/upgrade/chkextract 

/ usr/etc/upgrade/config_host 

/usr/etc/upgrade/extract 

/usr/etc/upgrade/extract_client 

/ usr/etc/upgrade/extract_clntroot 

/usr/etc/upgrade/extract__stand 

/ usr/etc/upgrade/include 

/usr/etc/upgrade/includefile 

/usr/etc/upgrade/get_arch 

/usr/etc/upgrade/get_clientinfo 

/usr/etc/upgrade/get_machtype 

/usr/e tc/upgrade/get_tapemfo 
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SUNUPGRADE(8) 


MAINTENANCE COMMANDS 


SUNUPGRADE(8) 


/usr/etc/upgrade/get_toc 

/usr/etc/upgrade/get_upgrademfo 

/usr/etc/upgrade/mop_up 

/ usr/etc/upgrade/mount_ufs 

/usr/etc/upgrade/mountusr 

/usr/etc/upgrade/start_log 

/usr/etc/upgrade/setup_kvm 

/usr/etc/upgrade/small_kernel_files 

/usr/etc/upgrade/sun2_cp_share 

/usr/etc/upgrade/sun2_lii_exec 

/usr/etc/upgrade/sunupgrade 

/usr/etc/upgrade/tar^clntroot 

/usr/etc/upgrade/verify_clntpart 

/usr/etc/upgrade/xdrtoc 

SEE ALSO 

suninstall(8) 

Installing the SunOS 4.0.3 
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10.3. GLOSSARY 

architecture 

auto-boot 

binding 

boot block 

booting 

bootparams 

bootstrap program 

bus 

configuration, equipment 

controller 

copy program 
daemon 


The specific components of a computer system and the way they interact with 
one another. From a Sun kernel perspective, architecture refers to the type of 
CPU chip in the computer. A Sun-2 machine is said to have 68010 architecture, 
because it contains this CPU chip. A Sun-3 has 68020 architecture. A Sun-4 is 
considered to have SPARC architecture, because it contains a SPARC chip. 

An automatic booting process for a system, auto-boot is controlled by 
parameters, such as the name of the boot device, stored in the system EEPROM. 

The process during which a client finds out where a server is so that the client 
can receive services. NFS binding is explicitly set up by the user and remains in 
effect until the user terminates the bind, for example by modifying the 
/e t c / f St ab file. YP binding occurs when a client’s request is answered by a 
server and is tenninated when the server no longer responds. 

Booting information stored in the first 8 Kbyte block on a disk. It contains the 
disk label, and a small program which is the first step in the boot process. 

The process of powering up the computer, testing to determine which attached 
hardware devices are running, and bringing the operating system kernel into 
memory and operation. 

Values used by a server to boot a diskless client. The location of the client root 
and swap are the minimum required parameters. These parameters are located in 
the /etc/bootparams file. 

The program(s) which brings a system to an operational state by loading the 
operating system from disk or over the network. 

A cable or circuit used for the transfer of data or electrical signals among dev¬ 
ices. 

The combination of CPU, peripherals, and software, and the way they are inter¬ 
connected to form a system. 

A circuit board that controls the operation of another device or system, such as a 
graphics board that controls a graphics color monitor. 

A program used to copy the miniroot from the distribution tape to the disk. 

A process that handles system-wide functions, such as netwoik administration or 
line printer spooling operations. Typically, a daemon remains inactive (sleeps) 
until caUed upon to perform a given task. 


^sun 
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dataless client 

defect list 

device 

device driver 

diagnostics 

diskless client 


distribution tapes 

domain 

dump 

Ethernet 

Ethernet address 


A dataless client relies on the server for its home directory, and on a local disk 
for its root directory and swap file. 

A list of defects on a disk that the disk manufacturer supplies in hard copy. An 
on-line version of the defect list is stored in a reserved area on the disk drive. 

The format program allows you to update the defect list if more defects are 
discovered. 

A hardware component acting as a unit that performs a specific function, such as 
formatting and printing output (a printer) or reading and writing information on a 
disk (a disk drive). SunOS treats all devices as files. 


A routine, or set of routines, within the kernel that controls the operation of a 
device. For example, the operation of the SCSI disk controller is handled by a 
disk device driver. 

Sets of performance tests run on a system to verify that it is performing properly 
in various areas. The system automatically runs a set of diagnostics, or self tests, 
when the system boots. 

A diskless client relies on the server for all resources, specifically, for its: 

□ root directory: /root 

□ swap file: / swap 

□ home directory: /home 

□ directory of architecture dependent executables: /export/exec/ARCH 

□ directory of sub-architecture dependent executables: 

/export/exec/kvm/ARCH 


A set of half-inch magnetic tape reels or quarter-inch tape cartridges that contain 
the software needed to load the operating system. 

A name given to a group of workstations on a single local netwoik that share 
administrative files. The workstations belonging to a domain access the same YP 
maps. 

The process of copying filesystems onto a tape for offline storage, using the 
dump command. 

A commonly-used local area network technology originally developed by Xerox 
Corporation. 

The address permanently assigned to each workstation. The address is a 6-byte 
hexadecimal value with bytes separated by colons. A typical Ethernet address is: 
8:0:20:0:14:76 
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exec path 


The pathname on a server used by a client to find its architecture-dependent exe¬ 
cutables. 


export 

filesystem 

format 

free hog disk partition 


gateway 

GENERIC kernel 


global file 

head 

heterogeneous server 

homogeneous server 
host 

hostname 

ifconfig 

inode 

installation 


A hierarchical arrangement of directories and files. 

format is a SunOS utility that formats, labels, repairs, and analyzes disks on a 
Sun system. 

A disk partition that is a holding place for un-needed disk space. The space is 
held in the free hog disk partition until you allocate the space to another area. 
This partition is where disk space is taken from when you increase a partition 
size. 

A machine that enables different networks to communicate with each other. 

The version of the UNIX kernel that is shipped on the release tape. It contains 
entries for all devices and software available for a specific architecture of a 
specific release. It is advised that the GENERIC kernel be edited to suit the 
configuration of the installed system. 

A file containing information such as user, host, and networic names, that is net¬ 
work wide in scope. 

The mechanism on a disk drive that reads and writes information on a disk. 

An NFS server that has clients of its own architecture and other architectures. 
For example, a Sun-4 server that has Sun-2 and Sun-3 clients is a heterogeneous 
server. 

An NFS server that has clients only of its own architecture. 

A computer attached to a network. 

The name of a workstation. Also known as a machine name. Hostnames are 
allowed up to 32 alpha/numeric characters. All alphabetical characters must be 
lower case. 

A command used to enable a network. The if conf ig command assigns an 
Internet (IP) address to the network being configured. 

An entry in a pre-designated area of a disk that describes where a file is located 
on that disk, the file’s size, when it was last used, and other identification infor¬ 
mation. 

Loading the operating system software and bringing up a workstation. 
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installation roadmap 
interface 
internetwork 
Internet 

Internet address 

kernel 


kvm path 

label 

library routine 

local file 

local installation 

local tape drive 
machine name 

map 

makefile 


An outline of the steps required to complete an installation. 

A connection to a network. 

A group of networks interconnected with routers, which uses the IP protocol. 

A nation wide area network using internet protocol (IP) that was originally spon¬ 
sored by the Defense Advanced Research Project Agency (DARPA). 

A machine’s Internet address (IP) is a unique number that consists of two parts: 
the network number followed by the host number. 

The master program set of SunOS software that manages all the physical 
resources of the computer, including file system management, virtual memory, 
reading and writing files to disks and tapes, scheduling of processes, printing, and 
communicating over a network. 

The pathname on the server used by a client to find its sub-architecture dependent 
executables. 

Information written by the format program on sector 0 of a disk. The disk 
label describes the size and boundaries of the disk’s partitions. 

A series of SunOS functions that can be called by user programs written in C and 
other compatible programming languages. 

A file containing information specific to the machine where it resides. When 
using YP, the local file is checked first before a corresponding global file is 
checked. 

An installation where a disk and tape drive are cormected to the machine on 
which you are installing SunOS. This machine may or may not be cormected to 
the network. 

A tape drive located at your Sun Workstation. 

The name of a workstation. Also known as the hostname. A machine name is 
allowed up to 32 alpha/numeric characters. All alphabetical characters in the 
machine name must be lower case. 

A file used by the Yellow Pages service that holds information of a particular 
type, for example, the password entries of aU users on a network or the names of 
ill host machines on a network. 

A file used by the make command, which describes files that make must process 
and programs that make must run. 
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miniroot 

A small version of the operating system that is loaded into the swap partition. 

The miniroot provides just enough functionality to install the overall operating 
system. 

When you load the miniroot, you copy it from tape to disk. 

When you boot the miniroot, you make it active. Once the miniroot is activated, 
you can run suninstall. 

modem 

An electronic device that you can use to connect a Sun workstation to a tele¬ 
phone line. 

mount 

The process of accessing a directory from a disk attached to the machine making 
the moimt request (4.2 mount) or remote disk on a network (NFS mount). 

mount point 

An empty directory within a client directory hierarchy through which the client 
mounts remote directories that it receives from a server in an NFS or RFS mount 
Machines with disks use a mount point to mount directories from a local disk. 

MUNIX 

MUNIX (Memory-resident UNIX) is a small version of the operating system that 
is loaded from tape, or over the network, into memory rather than on disk. It is a 
useful tool when the local system disk is either corrupted or unformatted, as it 
allows you to run format. 

netgroup 

A network-wide group of machines granted identical access to certain network 
resources for security and organizational reasons. 

network (local area) 

A network consisting of a number of machines that share resources such as files 
and mail. The network covers a physically limited area no greater than two 
miles. 

network (wide area) 

A network consisting of one or more large computers providing services such as 
file transfer, and a large number of client computers that use the services. This 
netwoik may cover a large physical area, sometimes spanning the globe. 

newf s 

A Sim command that is used to make a filesystem. Typically, newf s is run 
before restoring a filesystem from tape, newf s calls the makef s command to 
make a filesystem on a device. 

NFS 

The Sun Netwoik File System (NFS) is a service that is a netwoiking protocol 
which enables clients to receive files across a network from a file server. 

packet 

A group of information in a fixed format that is transmitted as a unit over com¬ 
munications lines. 

platter 

A flat disk made of magnetic media that is mounted on a spindle. A disk such as 
those used by Sun computers actually is composed of a number of platters. 
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page A standard unit of memory with an architecture-dependent size that is the smal¬ 

lest entity manipulated by the kernel’s virtual memory system. 

partition A discrete portion of a disk, configured during installation, and assigned to a 

specific file system. 

post-installation procedures A set of procedures performed after the installation to re-customize the environ¬ 
ment. Post-installation procedures are used when re-installing an existing sys¬ 
tem. They restore the environment after the installation is completed. 

pre-installation procedures A set of procedures performed prior to the installation to preserve an existing 

environment. Pre-installation procedures are used when re-instaUing an existing 
system. 

A program in operation. For example, a daemon is a system process that is 
always running on the system. (If it stops running, you have to start it up.) 

A set of formal rules explaining how hardware and software on a network should 
interact in order to transmit information. 

pseudo-device Software subsystems or drivers with no associated hardware. 

ramdisk The use of virtual memory to replace a disk for applications that require intensive 

disk access. 


process 

protocol 


re-installation, system 


remote installation 


remote procedure calls 
root partition 
root user name 


router 


A re-installation is a full installation of an existing system. Procedures for 
preserving and restoring the existing environment must be performed in this type 
of installation. A re-installation is required when adding the functionality of a 
major release. 

An installation in which the machine you are installing does not have a tape drive 
connected to it, but there is a local disk. Instead of using a local tape drive, you 
use the tape drive of another machine on the network to perform the installation. 
This type of installation requires that the system you are installing be connected 
to the network. 

Routines that enable communication between two remote programs. 

The disk space (partition) allocated for the root filesystem. 

SunOS user name that grants special privileges to the person who logs in with 
that ID. If the user can supply the correct password for the root user name, he or 
she is given supemser privileges for the particular machine. 

A program that forwards information of a certain protocol type from one network 
to another. 
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sector 

server 

software categories 

standalone machine 

sub-architecture 

subnet 

suninstall 

SunOS 

superblock 

superuser 

swap 

symbolic link 

tapehost 

tar utility 
target machine 


A segment of a disk track, which, on Sun systems, holds 512 bytes of data. 

A machine that provides a network service, such as disk storage and file transfer, 
or a program that handles such a service. 

Available software on the distribution tape. There are approximately 20 
categories (e.g. Programming, Accounting, SunViewl) to select from when using 
the Software Form in suninstall. 

A workstation with its own disk and tape drives that does not rely on a server in 
order to boot. 

A variant within a hardware architecture where the layout of the kernel is slightly 
dissimilar. For example, a 68030-based Sun-3/80, a Sun-3x, is a sub-architecture 
of the Sun-3 family. To find the sub-architecture of a machine, type arch -k. 

A networking scheme that divides a single logical netwoik into smaller networks 
to simplify routing. 

A tool to install and maintain the 4.x operating system on Sun Woikstations. 
suninstall replaces Setup, the 3.x installation tool. 

SunOS is the Sun UNIX based operating system incorporating Berkeley 4.2 and 
System V. 

A block on the disk that contains information about particular file systems, such 
as the file system name, size in blocks, and so on. 

A user with special privileges granted if he or she supplies the correct password 
when logging in as root or using the su command. For example, only the 
superuser can change the password file and edit major system administration files 
in / etc. 

A disk partition or a remote file which the kernel uses in cases of memory 
overflow. 

A file that consists of a reference to the name of another file. The kernel 
translates accesses to the symbolic link into accesses to the file it refers to. 

A machine which has a tape drive that is used by another machine during a 
remote installation. 

A program that you use for backing up and restoring files to tape. 

A target machine is the machine you are installing during a remote installation. 
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system administrator 
time-sharing system 


track 


upgrade, system 
virtual memory 


yellow pages 


yp database 


Ypinit 


The person responsible for setting up and maintaining a computer system and/or 
network of computer systems. 

A standalone Sun workstation with dumb terminals attached to its serial ports. 
The terminals rely on the workstation for processing power as well as file service 
and disk storage. 

A concentric ring on a disk that passes under a single stationary disk head as the 
disk rotates. 

A system upgrade is installing the functionality of a minor release. In a standard 
upgrade, files in each architecture are selectively replaced. 

A memory management technique used by SunOS for programs that require 
more space in memory than can be allotted to them. The kernel moves only 
pages of the program currently needed into memory, while unneeded pages 
remain on the disk. 

A network service provided by Sun which allows you to maintain certain global 
information for an entire network. For example, one yellow pages password file 
lists all the accounts on a network. 

A set of files containing global information that the yp programs access for infor¬ 
mation. 

A yp program that is used to install a yp database. 
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SunOS 3.x Directory Structure 
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A 


SunOS 4.0.3 and 3.x Directory 

Structures 

For a clearer picture of the filesystem changes between 4.0.3 and 3.x, compare 
the following directory trees. Wherever an arrow (=>) appears after a directory 
name, this indicates a symbolic link to the directory following the arrows (eg.: 
/bin => usr/bin ). 

Figure A-1 SunOS 4.0.3 root Filesystem Directory 









226 Installing the SunOS 4.0.3 


Figure A-2 


SunOS 4.0.3 /usr Filesystem Directory 

f - 


/usr 



../var/adm 

../kvm/boot 



share/man 

kvm/mdec 


../var/spool 

kvm/stand 

share/sys 

../var/tmp 


1608 
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Figure A-3 SunOS 4.0.3 / e-xport Filesystem Directory for Servers 
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Figure A-6 SunOS 3jc /mst Directory 


adm 

bin 

crash 

demo 

diet 


../private.MC68020/usr/adm 


games 

hosts 

inciude 

iib 

iocai 


mdec 

preserve 

pub 


../private.MC68020/usr/preserve 


spooi 


./private.MC68020/usr/spooi 


stand 


../private.MC68020/usr/tmp 


sun 

microsystems 


Revision A, of 25 April 1989 













Time Zones 


TIME ZONE NAME: 

TIME ZONE AREA: 

North America; 

US/Eastem 

Eastern time zone, U.S.A. 

US/Central 

Central time zone, U.S.A. 

US/Monntain 

Mountain time zone, U.S.A. 

US/Pacific 

Pacific time zone, U.S.A. 

US/Pacific-New 

Pacific time zone, U.S.A., 
with proposed changes to Daylight Savings 
Time near election time in Presidential 
election years 

us/Yukon 

Yukon time zone, U.S.A. 

US/East-Indiana 

Eastern time zone, U.S.A., 
no Daylight Savings Time 

us/Arizona 

Mountain time zone, U.S.A., 
no Daylight Savings Time 

us/Hawaii 

Hawaii 

Canada/Newfoundland 

Newfoundland 

Canada/Atlantic 

Atlantic time zone, Canada 

Canada/Eastem 

Eastern time zone, Canada 

Canada/Central 

Central time zone, Canada 

Canada/East-Saskatchewan Central time zone, Canada, 

no Daylight Savings Time 

Canada/Moimtain 

Mountain time zone, Canada 

Canada/Pacific 

Pacific time zone, Canada 

Canada/Yukon 

Yukon time zone, Canada 

Europe: 

GB-Eire 

Great Britain and Eire 

WET 

Western European time 

Iceland 

Iceland 

MET 

Middle European time (also known as 
Central European time) 

Poland 

Poland 

EET 

Eastern European time 
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Turkey Turkey 

W-SU Western Soviet Union 

Asia (including Australia and New Zealand): 


PRC 

People’s Republic of China 

Korea 

Republic of Korea 

Japan 

Japan 

Singapore 

Singapore 

Hongkong 

Hong Kong 

ROC 

Republic of China 


Australia/Tasmania 

Tasmania, Australia 

Australia/Queensland 

Queensland, Australia 

Australia/North 

Northern Territory 

Australia/West 

Western Australia 

Australia/South 

South Australia 

AustraliaA^ictoria 

Victoria, Australia 

Australia/NSW 

New South Wales, Australia 

NZ 

New Zealand 


Other (if the locale isn’t listed above); none of these have Daylight Savings 
Time: 


GMT 

GMT-1 

GMT-2 

GMT-3 

GMr-4 

GMT-5 

GMT-6 

GMT-7 

GMT-8 

GMT-9 

GMT-10 

GMT-11 

GMT-12 

GMT+13 

GMT+12 

GMT-i-11 

GMT+10 

GMT-t-9 

GMT-hS 

GMT-hV 

GMT-t-6 

GMT-i-5 

GMT+4 

GMT+3 


Greenwich Mean time 

1 hours west of Greenwich Mean Time 

2 hours west of Greenwich Mean Time 

3 hours west of Greenwich Mean Time 

4 hours west of Greenwich Mean Time 

5 hours west of Greenwich Mean Time 

6 hours west of Greenwich Mean Time 

7 hours west of Greenwich Mean Time 

8 hours west of Greenwich Mean Time 

9 hours west of Greenwich Mean Time 

10 hours west of Greenwich Mean Time 

11 hours west of Greenwich Mean Time 

12 hours west of Greenwich Mean Time 

13 hours east of Greenwich Mean Time 
12 hours east of Greenwich Mean Time 
11 hours east of Greenwich Mean Time 
10 hours east of Greenwich Mean Time 
9 hours east of Greenwich Mean Time 
8 hours east of Greenwich Mean Time 
7 hours east of Greenwich Mean Time 
6 hours east of Greenwich Mean Time 
5 hours east of Greenwich Mean Time 
4 hours east of Greenwich Mean Time 
3 hours east of Greenwich Mean Time 
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GMT+2 

GMT+1 


2 hours east of Greenwich Mean Time 
1 hours east of Greenwich Mean Time 



microsystems 


Revision A, of 25 April 1989 




SunOS 4.0.3 Upgrade Distribution Tape 
Layout 


SunOS 4.0.3 Upgrade Distribution Tape Layout 
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SunOS 4.0.3 Upgrade Distribution Tape 

Layout 

The following table is representative of the files contained on the OS Upgrade 
4.0.3. 

To display a list of exact files and file sizes that are contained on your OS 4.0.3 
Upgrade tape, see the next page. 


microsystems 


239 


Revision A, of 25 April 1989 







240 Installing the SunOS 4.0.3 


4.0.3 Upgrade Tape * Sun-4 1/2" 


Name 

Description 

Size 

Format 

MB 

boot 

A general purpose bootstrap program. 

49152 

image 

m 

XDRTOC 

Table of Contents in x(Ir(3N) format. 

4096 

toe 


copy 

Standalone copy. 

49664 

image 

1/3 

mini-root 

An image of a mini version of SunOS. 

6154240 

image 

1/4 

munix 

Memory UNIX. 

1040896 

image 

1/5 

munixfs 

The MUNIX initialization file. 

2105344 

image 

1/6 

root 

The complete root file system for SunOS. 

1228800 

tar 

1/7 

usr 

Required /usr files. 

9512960 

tar 


Kvm 

Kernel executable files. 

3143680 

tar 

MB 

Install 

Installation and system administration tools. 

983040 

tar 

1/10 

Sys 

/usr/share/sys files for making custom kernels. 

1853440 

tar 

1/11 

Networidng 

Networking tools and programs. 

317440 

tar 

1/12 

Debugging 

Debugging tools. 

4157440 

tar 

1/13 

SunView_Users 

SunWindows for users. 

1198080 

tar 

1/14 

SunView_Programmers 

SunWindows files for programmers. 

1372160 

tar 

1/15 

SunView_Demo 

SunWindows demo programs source. 

51200 

tar 

1/16 

User_Diag 

Sysdiag. 

4055040 

tar 

1/17 

Graphics 

Graphics programmer’s files. 

1474560 

tar 

1/18 

UUCP 

UUCP files. 

61440 

tar 

1/19 

System_V 

System V compatibility files. 

3952640 

tar 

1/20 

Manual 

On-line man pages. 

71680 

tar 

1/21 

Demo 

Assorted graphics demonstrations including 
Graphics Processor source. 

256000 

tar 

1/22 

Games 

Game programs. 

1372160 

tar 

1/23 

Versatec 

Versatec raster printer/plotter support. 

20480 

tar 

1/24 

Security 

C2 security support. 

102400 

tar 

1/25 

Copyright 

The copyright file. 

1024 

image 
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Determining Exact Distribution To determine the exact files and file sizes contained on your distribution tapes, 
Tape Information type the following commands: 

f -^ 

scuzzy# mt -f /da^/nrstO asf 1 

scuzzy# dd if=/dev/nr^rO 1 /usr/etc/install/xdrtoc 

V_ / 


You will receive a display similar to the following reflecting the files for your 
architecture type: 


/- 




. . \ 

11+0 

records 

in 



11+0 

records 

out 



SunOS 4.0.2 

of Thu Feb 9 18 

:14:00 PST 

1989 from 

Sun 

Release 

Engineering 



ARCH 

sun4 




VOLUME 1 




Vol 

File 

Name 

Size 

Type 

1 

0 

boot 

40960 

image 

1 

1 

XDRTOC 

4096 

toe 

1 

2 

copy 

49664 

image 

1 

3 

mini-root 

6246400 

image 

1 

4 

munix 

958976 

image 

1 

5 

munixfs 

1638400 

image 

1 

6 

root 

1228800 

tar 

1 

7 

usr 

10649600 

tar 

1 

8 

Sys 

9625600 

tar 

1 

9 

Copyright 

1024 

image 

2 

0 

boot 

40960 

image 

2 

1 

XDRTOC 

4096 

toe 

2 

2 

Networking 

409600 

tar 

2 

3 

Debugging 

4198400 

tar 

2 

4 SunView Users 

1228800 

tar 

2 

5 SunView_Programmers 

1433600 

tar 

2 

6 

SunView Demo 

102400 

tar 

2 

7 

Install 

921600 

tar 

2 

8 

User Diag 

3788800 

tar 

2 

9 

SunCore 

1433600 

tar 

2 

10 

UUCP 

102400 

tar 

2 

11 

System_V 

12492800 

tar 

2 

12 

Manual 

102400 

tar 

2 

13 

Demo 

204800 

tar 

2 

14 

Games 

1433600 

tar 

2 

15 

Versatec 

102400 

tar 

2 

16 

Security 

102400 

tar 

2 

17 

Copyright 

1024 

image 

V 




___y 
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Extracting Information on 
Individual Software Category 
Files 


To extract information on individual files that comprise a Software Category, use 
the following procedure: 

1. Load the distribution tape which contains the desired Software Category. 

2. Skip to the correct file. 

3. Extract the tar table of contents. 

For example, to see the files included in the uucp category, referring to the tape 
Table of Contents above and assuming 1/4" tape: 

1. Mount Tape 2 of the distribution. 

2. Execute the following: 


-- 

scuzzy# nrt --f /dev/nrjsfO asf 10 
scuzzy# tar tvf /dw/nrstO 

rwxrwxr-x 4/10 0 Feb 9 14:46 1989 ./lib/uucp/ 

rwx- 4/10 648 Feb 3 14:47 1989 ./lib/uucp/uuck 

— X - 4/10 16384 Feb 3 14:47 1989 */Ixb/uucp/uusub 

—s — X — X 4/10 32768 Feb 3 14:47 1989 ./lib/uucp/uuxqt 

scuzzy# 

V_✓ 
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Installation Worksheets. 245 

D.l. Introduction. 245 

D.2. Network Information Worksheets. 245 

D.3. Disk and Qient Information Worksheets. 247 

D.4. Pre-installation Checklist. 249 

Hardcopy of the Following:. 249 

If Running YP:. 249 

Mount Points:. 249 

Copy Files:. 250 

Save Files:. 250 

Halt Clients:. 251 

Clean Up the Filesystem:. 251 

FuU Dumps. 251 

D.5. Installation Checklist. 252 

D.6. Post-installation Checklist. 253 























Installation Worksheets 


D.l. Introduction The following worksheets are provided as a checklist for gathering information 

and performing installation procedures. They are divided into four categories: 

□ Network Information 

□ Disk and Qient Information 

□ Pre-installation Procedures 

□ Installation Procedures 

□ Post-installation Procedures 

For more information on any of these categories, see the appropriate chapter in 
this manual. 

D.2. Network Information For more information on gathering network information, see the Getting Started 
Worksheets chapter of this manual. 
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Installation Network Information 


Yellow Pages Domain Name: 


Hostname 

Internet Address (IP) 

Ethernet Address 
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D.3. Disk and Client The following woilcsheets are for disk and client information when performing 

Information server installations. 

Worksheets 


Disk and Client Information 


Server name: 

Server Internet address: 


Disk 1: 


Disk Information 

Partition 

Size 

Mount Pt. 

Preserve 


































Disk 2: 


Disk Information 

Partition 

Size 

Mount Pt. 

Preserve 
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Qient Information 


Arch 

IP Address 

Swap 

Ethernet 

Halted Y/N 
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D.4. Pre-installation 
Checklist 


Pre-installation procedures are used to preserve the customized environment 
when re-installing an existing system. For more detailed information, see Get¬ 
ting Started in this manual. 


Hardcopy of the Following: 


If Running YP: 


. Output from mount -p 
. Output from dkinf o command 
. List of clients and IP addresses 
. Swap space for each client 
. Architecture for each client 
. Unusual kernel requirements for clients 
. Hardcopy of configuration files 

Copy old/etc/exports, /etc/fstab, /etc/crontab, 
/ etc/passwd files. 

IP address of machine being upgraded 

IP address of second Ethernet interface 

Edit YP master bootparams map. 

Fix YP pas swd master. 


Mount Points: 


Make a list of all mount points and links added to 
/ and /usr. 
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Copy Files: 


Copy files from the following; 

_ /usr/local 

_ /usr/spool/mail 

_ /home directories 

_Other locally created directories: 


Save Files: 


Save copies of the following files: 

_ /etc/passwd 

_ /usr/lib/aliases 

_ /etc/aliases 

_ /sendmail.cf 

_ /etc/hosts 

_kernel configuration files 

Other customized files: 
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Halt Clients: 


Halt the following clients: 


Clean Up the Filesystem: 


Runfsck -p. 


Full Dumps 


Perform full dumps of aU system partitions for the following clients: 
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D.5. Installation Checklist The following checklist is for the procedures leading up to running suninstall. 

For more detailed information, see Beginning the Installation in this manual. 

_Mount the distribution tape 

_Load the bootstrap program 

_ CopyMUNIX 

_BootMUNIX 

_Format and label the disk 

_ Copy the miniroot 

_Boot the miniroot 

_ Run suninstall 


msun 

Nr microsystems 
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D.6. Post-installation 
Checklist 


The following checklist is for the procedures you perform after running sunin- 
stall to re-customize the environment For more detailed information, see the 
Post-installation Procedures chapter in this manual. 


Install patch tapes 

Move the following saved files back to /usr: 
_ /usr/local 


Edit /etc/ttytab 
Adjust ordering of f sck 

Verify if config lines in /etc/rc . local or 
rc.boot 

Customize /etc/exports 
Integrate old f stab entries 
Merge old crontab entries 
Configure the kernel 
Check modes in /etc/dumpdate 
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Check system scripts for reference to old partitions: 

_ dump 

_ restore 


Run catman. 

Back up the system 
Reboot clients 
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suninstall Forms. 257 

E.l. Time Zone and Terminal T)^. 258 

E.2. Host Form. 259 

E.3. Disk Forms. 260 

E.4. Software Form. 264 

E.5. QientForm. 265 













E 


suninstall Forms 

Introduction The following set of suninstall forms are worksheets to help you prepare for your 

installation. 

1. Time zone and terminal type 

2. Host Form 

3. Disk Form 

Fill out one for each disk drive. 

4. Software Form 

FiU out one for each architecture type. 

5. Client Form 

Fill out one for each client. 

Once you have filled out all the forms required for your environment, collate 
them into numerical order and then execute suninstall. 
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E.l. Time Zone and 
Terminal Type 


# cd /usr/etc/install 

# suninstall 

Enter the local time zone name: 

» _ 

Is this the correct date/time [y/n]: 


Select your terminal type: 

1) Televideo 925 

2) Wyse Model 50 

3) Sun Workstation 

4) Other 


»sun 

Nr microsystems 
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E,2. Host Form 


HOST FORM [DEL=erase 

one char of input data] [RET=end of 

input data] 

A 

Workstation Information 

Name : 





Type : [standalone] 

[server] 

[dataless] 



Network Information : 

Ethernet Interface 

Internet Address 0 

: [none] 

[ieO] 



YP Type 

Doma inname 

: [none] 

[master] [slave] [client] 


Misc Information : 

Reboot after completed : [y] 

[n] 



Are you finished with this form [y/n] ? 

[x/X=select choice] [space=next choice] ["B/"P=backward] 

V 

[~F/''N=forward] 

J 
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E.3. Disk Forms 

Disk Form: Standalone 
Configuration 


DISK FORM [DEL=erase one char of input data] [RET=end of input data] 


Attached Disk Devices : 

[ ] 


Disk Label : 
Freehog Disk Partition : 
Display Unit : 

PARTITION START CYL BLOCKS 


[default] [existing] [label in data file] 

[d] [e] [f] [g] [h] 

[Mbytes] [Kbytes] [bytes] [blocks] [cylinders] 
SIZE MOUNT PT PRESERVE(Y/N) 


a 

b 

c 

d 

e 

f 

g 

h 


Ok to use this partition table [y/n] ? _ 

Are you finished with this form [y/n] ? _ 

[x/X=select choice] [space=next choice] ["B/"P=backward] ["F/"N=forward] 
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Disk Form: Server 
Configuration 


DISK FORM [DEL=erase one char of input data] [RET=end of input data] 

Attached Disk Devices : 

[ ] 


Disk Label 

Freehog Disk Partition 
Display Unit 


[default] [existing] [label in data file] 

[d] [e] [f] [g] [h] 

[Mbytes] [Kbytes] [bytes] [blocks] [cylinders] 


PARTITION START CYL BLOCKS SIZE 


MOUNT PT 


PRESERVE(Y/N) 


Ok to use this partition table [y/n] ? 

Are you finished with this form [y/n] ? 


[x/X=select choice] [space=next choice] ["B/"P^backward] ["F/"N=forward] 
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Disk Form: Dataless 
Configuration 


f ^ 1 

DISK FORM [DEL=erase one char of input data] [RET=end of input data] 


Attached Disk Devices : 

[ ] 


Disk Label : [default] [existing] [label in data file] 

Freehog Disk Partition : [d] [e] [f] [g] [h] 

Display Unit : [Mbytes] [Kbytes] [bytes] [blocks] [cylinders] 

PARTITION START_CYL BLOCKS SIZE MOUNT PT PRESERVE(Y/N) 


a 

b 

c 

d 

e 

f 

g 

h 


Ok to use this partition table [y/n] ? _ 

Are you finished with this form [y/n] ? _ 

[x/X=select choice] [space=next choice] ["B/"P^backward] ["F/"N=forward] 
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Disk Form: Generic 



^sun 

Xr microsystems 
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E.4. Software Form 


SOFTWARE FORM [DEL=erase one char of input data] [RET=end of input data] 


Architecture Information : 

Type : [sun2] [sun3] [sun3x] [sun4] [sun4c] 

Path where executables reside :_ 

Path where sub-arch dependent executables reside : 

Media Information: 

Device Type : [arO] [ar8] [stO] [mtO] [xtO] 

Drive Type : [local] [remote] 

Tapehost : _ 

Tapehost's Internet Address :_ 

Choice : [all] [default] [own choice] [required] [quit] 


CATEGORY NAME BYTES AVAIL BYTES Y/N 


OK to use this extract list [y/n] ? _ 

Are you finished with this form [y/n] ? _ 

[x/X=select choice] [space=next choice] ["B/"P=backward] ["F/"N=forward] 
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E.5. Client Form 


CLIENT FORM [DEL=erase one char of input data] [RET=end of input data] 


Architecture Type : [sun2] [sun3] [sun3x] [sun4] [sun4c] 

Choice : [create] [delete] [display] [next arch] 

Client(s) : 


Client Information : 

Name : _ 

Internet Address : _ 

Ethernet Address : _ 

YP Type : [none] [master] [slave] [client] 

Domain name : _ 

Path of Client's Root : _ 

Path of Client's Swap : _ 

Path of Client's Home : _ 

Path of Client's Executables : _ 

Path of Client's Sub-arch Dependent Execs : _ 

Swap size (e.g. 8M^8m^8K^8k,8 or 8b) : _ 

Are you finished with this form [y/n] ? _ 

[x/X=select choice] [space=next choice] ["B/"P=backward] ["F/"N=forward] 
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Index 


A 

abort sequence, 43 
adding a client, 164 
advanced installation issues, 159 
architecture 

definition, 214 
auto-boot 

definition, 214 

B 

binding 

definition, 214 
boot block 

definition, 214 
booting 

definition, 214 
booting issues, 22 
booting the miniroot, 60 
bootparams 

definition, 214 
bootstrap program, 47 
definition, 214 

bootstrap program, how to load, 49 
bootstrap program, loading, 48 
bus 

definition, 214 

c 

client form, 82 
client form menu items, 83 
client information, 72 
client workstation 

Ethernet address, 41 
host number, 41 
internet address, 40 
configuration, equipment 
definition, 214 

configuring a custom kernel, 151 
controller 

definition, 214 
copy Program, 58 
definition, 214 

custom kernel configuration, 151 


D 

daemon 

definition, 214 
dataless client, 14 
definition, 215 

dataless local installation walkthrough, 114 
dataless remote upgrade, 193 
date/time format, 68 
defect list, 55 

definition, 215 
device 

definition, 215 
device driver 

definition, 215 
pseudo-device, 219 
Device Names, UNIX, 16 
diagnostics 

definition, 215 

directory structures, 4.x and 3.x, 22 
disk 

boot block, 214 
head, 216 
inode, 216 
label, 217 
partition, 219 
platter, 218 
sector, 220 
superblock, 220 
track, 221 

disk device names, 16 
disk form, 75 
disk form menu items, 76 
disk formatting, 50 
disk information, 71 
disk partitioning standards, server, 35 
disk partitioning standards, standalone, 35 
disk planning issues, 35 
disk space, planning, 31 
disk structure, 32 
diskless client, 13 
definition, 215 
distribution tape, 48 
distribution tape, mounting, 48 
distribution tapes 
definition, 215 
distribution tapes, mixed, 17 
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document conventions, 5 
document structure, 3 
domain 

definition, 215 
domain name, 15, 40 
dump, see backing up file systems 
definition, 215 

E 

Ethernet 

definition, 215 
ethemet address, 14,40, 41 
Ethernet address 
definition, 215 
ethemet types, 16 
exec path 

definition, 216 
export 

definition, 216 

F 

files 

symbolic link, 220 
filesystem 

definition, 216 

filesystem organization, 4.x, 19 
font types, 5 
format, 15,50, 51 
definition, 216 
format program, 47 
format utility 

format, 216 
format, how to start, 53 
formatting the disk, 50 
free hog disk partion 
definition, 216 
free hog disk partition, 77 

G 

gateway 

definition, 216 
GENERIC kernel 
definition, 216 
global file 

definition, 216 
glossary, 214 


host number, 41 
hostname, 14, 40 
definition, 216 

I 

icons, 6 
ifconfig 

definition, 216 
inode 

definition, 216 
install, what happens, 12 
installation 

definition, 216 

installation issues, advanced, 159 
installation methods, 11 
installation priority, 22 
installation roadmap 
definition, 217 
installation roadmaps, 26 
installation terminology, 47 
installation vs upgrade, 11 
installation, basic steps, 12 
installation, beginning, 47 
installation, how long, 84 
installation, when to, 12 
installing a root password, 86 
interface 

definition, 217 
Internet 

definition, 217 
internet address, 15, 40, 41 
Internet address 
definition, 217 
internetwork 

definition, 217 
IP, 41 

K 

kernel 

architecture types, 214 
definition, 217 
device driver, 215 
page, 219 
process, 219 
kvm path 

definition, 217 


H 

hardware ethemet address, 14, 41 
head, 216 

definition, 216 
heterogeneous server, 13 
definition, 216 
homogeneous server, 13 
definition, 216 
host, 216 

definition, 216 
host form, 73 
host form menu items, 74 
host information, 71 


L 

label 

definition, 217 
library routine 

definition, 217 
local area network 
definition, 218 
local file 

definition, 217 
local installation 
definition, 217 

local installation walkthrough: dataless, 114 
local installation walkthrough: server, 103 
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local installation walkthrough: standalone, 94 
local tape drive 
definition, 217 

local upgrade, standalone, 178 

M 

machine name, 14,40 
definition, 217 
machine types, 13 
main menu, 71 
main menu items, 71 
makefile 

definition, 217 
manual pages, 209 
manual pages, names of, 7 
map 

definition, 217 

methods for installation and upgrade, 11 
miniroot, 47, 15 
definition, 218 
miniroot, booting, 48, 60 
definition, 218 
miniroot, copying, 47, 58 
miniroot, loading 
definition, 218 
minitroot boot example, 60 
mixed distribution tapes, install from, 17 
modem 

definition, 218 
mount 

definition, 218 
mount point 

definition, 218 
MUNIX, 48, 15, 50 
definition, 218 
MUNIX System, 58 
MUNIX, copying, 51 

N 

netgroup 

definition, 218 
network 

domain, 215 
Internet, 217 
internetwork, 217 
local area, 218 
packet, 218 
protocol, 219 

remote procedure call, 219 
subnet, 220 
wide area, 218 

network classifications, 38, 39 
network equipment 
gateway, 216 
modem, 218 
router, 219 

network information, determining, 38 
network information, gathering, 40 
network information, required, 39 
network number 


network number, continued 
default, 40 

network number classes, 39 
networking terminology, 14 
newfs 

definition, 218 

NFS 

definition, 218 

NFS—^network file system service 
binding, 214 
global file, 216 

o 

on-line forms, 67 
on-line help, 90 

operating system terminology, 15 

p 

packet, 218 

definition, 218 
page, 219 
page, kernel 

definition, 219 
partition 

definition, 219 
partition, disk, 77 
planning disk space, 31 
platter, 218 
platter, disk 

definition, 218 

post-installation procedures, 139 
definition, 219 
pre-installation issues, 41 
pre-installation procedures, 42 
definition, 219 
preface, 3 thru 1 

preparatory local installation steps, 91 
process 

definition, 219 
protocol 

definition, 219 
pseudo-device 

definition, 219 

R 

ramdisk 

definition, 219 
re-installation, system 
definition, 219 
reference, 209 
relabelling the disk, 58 
related manuals, 7 
remote installation, 123 
definition, 219 

remote installation walkthrough: standalone, 123 
remote procedure call 
definition, 219 

remote upgrade walkthrough: standalone, 200 
remote upgrade, dataless, 193 
remotehost, 15 
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removing a client, 165 
roadmap, installing a new system, 26 
roadmap, re-installing an existing system, 27 
roadmaps, installation, 26 
root partition 

definition, 219 

root password, how to install, 86 
root user name, 219 
definition, 219 
router 

definition, 219 

s 

sector 

definition, 220 
server, 13 

definition, 220 
heterogeneous, 216 
homogeneous, 216 
server information, 4.x, 16 
server installation issues, special, 17 
server local installation walkthrough, 103 
server name, 74 

server upgrade, heterogeneous, 184 
server workstation 
host number, 41 
internet address, 40 
server, heterogeneous, 13 
server, homogeneous, 13 
setup_client, 21 
setup_exec, 21 
small pre-configured kernel, 144 
software categories, 80 
definition, 220 
software form, 78 
software form menu items, 81 
software information, 72 
special server installation issues, 17 
standalone, 13 

standalone local installation walkthrough, 94 
standalone remote installation walkthrough, 123 
standalone remote upgrade, 200 
standalone system 
definition, 220 
standalone workstation 
host number, 41 
internet address, 40 

standalone/homogeneous server conversion, 22 
standalone/server conversion, 22 
standard kernel configuration file, Sun-2, 150 
standard kernel configuration files, 149 
standard kernel configuration files, Sun-3x, 151 
standard kernel configuration files, Sun-4,151 
standard kernel configuration, Sun-3, 150 
sub-architecture 
definition, 220 
subnet 

definition, 220 

Sun-2 standard kernel configuration file, 150 
Sun-3 standard kernel configuration, 150 


Sun-3x standard kernel configuration files, 151 
Sun-4 standard kernel configuration files, 151 
suninstall, 65, 66 
definition, 220 
suninstall changes, 4.x, 21 
suninstall forms, 67 
suninstall main menu, 71 
suninstall, starting, 67 
SunOS, 15 

definition, 220 

SunOS 3.x /pub Directory, 229 
SunOS 3.x /us r Directory, 230 
SunOS 3.x root Directory, 228 
SunOS 3.x Directory Structure, 228 

SunOS 4.0.3 /export Filesystem Directory for Servers, 227 

SunOS 4.0.3 /us r Filesystem Directory, 226 

SunOS 4.0.3 root Filesystem Directory, 225 

SunOS changes, 3.x to 4.x, 19 

SunOS device names, 15 

sunupgrade, 169 

superblock 

definition, 220 
superuser, 220 
swap 

definition, 220 
swapping, 48 
symbolic link 

definition, 220 
system administrator 
definition, 221 

system assumptions, walkthrough examples, 89 
system upgrade, 169 
definition, 221 

T 

tape device names, 16 
tapehost, 15 

definition, 220 
tar utility 

definition, 220 
target machine, 15 
definition, 220 

terminal types, how to enter, 69 
time estimates for installation, 85 
Time Zones, 233 
Asia, 234 

Australia/Tasmania, 234 
Europe, 233 
North America, 233 
Other, 234 

time-sharing system, 221 
definition, 221 
track 

definition, 221 

u 

UNIX 

Device Naming, 16 
upgrade, 169 
upgrade methods, 11 
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upgrade summary of steps, 176 
upgrade user-customized files, 170 
upgrade walkthrough examples, 177 
upgrade walkthrough: local heterogeneous server, 184 
upgrade walkthrough: local standalone, 178 
upgrade walkthrough: remote dataless, 193 
upgrade, files replaced, 170 
upgrade, system 
definition, 221 
upgrade, when to, 12 

V 

virtual memory, 221 

w 

walkthrough example: dataless remote upgrade, 193 
walkthrough example: local dataless, 114 
walkthrough example: local server, 103 
walkthrough example: local server upgrade, 184 
walkthrough example: local standalone, 94 
walkthrough example: remote standalone, 123 
walkthrough example: remote standalone upgrade, 200 
walkthrough example: upgrade local standalone, 178 
walkthrough examples, 89 
wide area network 
definition, 218 
Internet, 217 
working terminology, 13 

Y 

yellow pages 

definition, 221 
yp database 

definition, 221 
YP— yellow pages service 
global file, 216 
YP—^yellow pages service 
binding, 214 
domain, 215 
local file, 217 
map, 217 
ypinit 

definition, 221 
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